Hành viBehavioral

Commandaka Action, Transaction

Biến một yêu cầu thành object để lưu, xếp hàng, ghi log hoặc undo.Turn a request into an object so you can store, queue, log or undo it.

Độ khóDifficulty: VừaMedium
Mức phổ biếnUsage: Mức phổ biếnUsage 4/5
Thời gian đọcReading time: ~9 phút đọc~9 min read

Thảo luậnDiscussion

Ví dụ đời thườngReal-life analogy

Ở quán phở, bạn không chạy vào bếp nói với đầu bếp. Bạn gọi món, phục vụ ghi ra một tờ order rồi kẹp lên bảng. Tờ order đó có thể xếp hàng, chuyển cho bếp khác, gạch bỏ nếu khách đổi ý. Yêu cầu của bạn đã trở thành một 'vật' cầm nắm được.At a phở shop you don't run into the kitchen to talk to the cook. You order, the waiter writes a ticket and clips it on the rail. That ticket can wait in line, go to another cook, or be crossed out if you change your mind. Your request has become a 'thing' you can hold.

Vấn đề và giải phápProblem and solution

Không có patternWithout the pattern

Giỏ hàng của bạn có các thao tác: thêm món, áp voucher, đổi địa chỉ. Giờ sếp muốn có nút Undo, muốn ghi audit log mọi thao tác, và muốn retry thao tác lỗi. Nếu controller gọi thẳng cart.applyVoucher(), sau khi gọi xong thì không còn gì để nhớ — không biết đã làm gì, với tham số nào, để mà đảo ngược.Your cart has actions: add item, apply voucher, change address. Now the boss wants an Undo button, an audit log of every action, and retries for failed ones. If the controller calls cart.applyVoucher() directly, nothing remains after the call — no record of what was done, with which arguments, to reverse it.

Với CommandWith Command

Đóng gói mỗi thao tác thành một object Command có execute() và undo(), giữ sẵn receiver (Cart) và tham số. Invoker (CartHistory) chỉ biết gọi execute() rồi cất command vào stack. Undo = lấy command cuối ra và gọi undo(). Vì yêu cầu giờ là dữ liệu, bạn có thể xếp hàng, log, retry tuỳ ý.Wrap each action in a Command object with execute() and undo(), holding its receiver (Cart) and arguments. The Invoker (CartHistory) just calls execute() and pushes the command on a stack. Undo = pop the last command and call undo(). Since the request is now data, you can queue, log or retry it freely.

Thành phần tham giaParticipants

Command: Interface chung: execute() (và thường có undo()).Common interface: execute() (and often undo()).
ConcreteCommand: Giữ receiver + tham số, biết gọi đúng method của receiver.Holds the receiver + arguments and calls the right receiver method.
Receiver: Object làm việc thật (Cart, Order...).The object doing the real work (Cart, Order...).
Invoker: Kích hoạt command, lưu lịch sử, xếp hàng — không biết chi tiết nghiệp vụ.Triggers commands, keeps history, queues them — knows no business details.
Client: Tạo command cụ thể và đưa cho Invoker.Creates concrete commands and hands them to the Invoker.

Sơ đồ và luồng thực thiDiagram and execution flow

Dùng Tự chạy hoặc phím mũi tên để đi qua từng bước gọi giữa các object. Console hiển thị output tương ứng của chương trình.Use Autoplay or the arrow keys to step through each call between objects. The console shows the matching program output.

1Controller tạo ApplyVoucherCommand(cart, "FREESHIP") rồi đưa cho CartHistory.The controller creates ApplyVoucherCommand(cart, "FREESHIP") and hands it to CartHistory.

← →

console

1> history.run(ApplyVoucher(FREESHIP))

implementsimplementsextendsextendsgọi / dùngcalls / usestạo racreatesgửi qua channelsends via channel1thứ tự chạy (bấm để nhảy bước)execution order (click to jump)

Code: Java Spring Boot ⇄ GoCode: Java Spring Boot ⇄ Go

Cùng một bài toán, hai ngôn ngữ. Rê chuột hoặc focus vào chú thích (số màu cam) để làm nổi bật dòng code tương ứng.Same problem, two languages. Hover or focus an annotation (orange number) to highlight its line.

JavaSpring Boot 3 · Java 21Spring Boot 3 · Java 21

package com.shop.cart;

/** A request wrapped as an object: it knows its receiver and its arguments. */
public interface Command {1
    void execute();

    /** Reverse exactly what execute() did */
    void undo();2

    default String label() {3
        return getClass().getSimpleName();
    }
}

GoGo 1.23 · thư viện chuẩnGo 1.23 · standard library

package cart

import "context"

// Command turns a request into a value you can store, queue or undo.
type Command interface {
	Execute(ctx context.Context) error1
	Undo(ctx context.Context) error
}

type ApplyVoucher struct {
	Cart     *Cart  // receiver
	Code     string // argument
	previous string // saved for undo2
}

func (c *ApplyVoucher) Execute(ctx context.Context) error {3
	c.previous = c.Cart.Voucher
	return c.Cart.ApplyVoucher(ctx, c.Code)
}

func (c *ApplyVoucher) Undo(ctx context.Context) error {
	return c.Cart.ApplyVoucher(ctx, c.previous)
}

Khác biệt chính giữa Java và GoKey differences between Java and Go

01Java hay dùng Runnable/Callable làm command 'không undo' và nộp vào ExecutorService. Go dùng func() hoặc kiểu hàm riêng, gửi qua channel.Java often uses Runnable/Callable as 'no-undo' commands submitted to an ExecutorService. Go uses func() or a named function type sent over a channel.
02Java dùng ArrayDeque làm stack undo; Go dùng slice và tự cắt s[:len(s)-1].Java uses ArrayDeque as the undo stack; Go uses a slice and re-slices s[:len(s)-1].
03Command trong Go trả error từ Execute/Undo — invoker quyết định có lưu lịch sử hay không. Java thường để exception bay lên.Go commands return error from Execute/Undo — the invoker decides whether to record history. Java usually lets exceptions propagate.
04Trong Spring, Invoker có state (lịch sử) không nên là singleton bean; Go không có container nên vấn đề này ít gặp — bạn tự tạo History cho từng phiên.In Spring a stateful Invoker (history) shouldn't be a singleton bean; Go has no container so this rarely bites — you create a History per session yourself.

Ứng dụng thực tếReal-world usage

Runnable + ExecutorServiceRunnable + ExecutorService
executor.submit(() -> sendEmail(order)) — lambda là một command được xếp hàng và chạy trên thread khác. @Async, TaskScheduler của Spring cũng vậy.executor.submit(() -> sendEmail(order)) — the lambda is a command queued and run on another thread. Spring's @Async and TaskScheduler work the same way.
CQRS / Axon CommandGatewayCQRS / Axon CommandGateway
Các object như PlaceOrderCommand được gửi qua CommandBus tới handler — có thể log, retry, phân quyền tập trung.Objects like PlaceOrderCommand go through a CommandBus to a handler — centralised logging, retry and authorization.
Worker pool / job queue trong GoGo worker pools / job queues
chan func() hay thư viện như asynq, River lưu job (command đã serialize) vào Redis/Postgres để chạy sau.chan func() or libraries like asynq and River persist jobs (serialized commands) in Redis/Postgres to run later.
Undo trong trình soạn thảo & back-officeUndo in editors & back-offices
Màn hình soạn khuyến mãi, sắp xếp sản phẩm cho phép Ctrl+Z — mỗi thao tác là một command có undo.Promo editors or product-sorting screens with Ctrl+Z — each action is a command with undo.

Khi nào dùng và khi nào khôngWhen to use it, and when not

Nên dùng khiUse it when

Cần undo/redo, hoặc lịch sử thao tác để audit.You need undo/redo, or an action history for auditing.
Muốn xếp hàng, hẹn giờ hoặc chạy thao tác ở thread/goroutine/máy khác.You want to queue, schedule or run actions on another thread/goroutine/machine.
Muốn tách nơi 'ra lệnh' (UI, API, cron) khỏi nơi 'làm việc' (service).You want to decouple who 'issues' an action (UI, API, cron) from who 'performs' it (service).

Không nên dùng khiAvoid it when

Chỉ gọi một method đơn giản, không cần lưu, xếp hàng hay undo — gọi thẳng là đủ.You just call a simple method with no storing, queuing or undo — a direct call is enough.
Thao tác không thể đảo ngược (đã gửi SMS, đã trừ tiền) mà lại hứa có undo — hãy dùng hành động bù trừ thay vì undo giả.The action is irreversible (SMS sent, money charged) yet you promise undo — use a compensating action instead of a fake undo.

Ưu điểmPros

Tách người gọi khỏi người thực hiện.Decouples the caller from the performer.
Dễ thêm undo/redo, log, retry, xếp hàng mà không sửa receiver.Undo/redo, logging, retry and queuing come without touching the receiver.
Ghép nhiều command thành macro command (chạy một lần cả loạt).Commands can be combined into a macro command (run a batch at once).

Nhược điểmCons

Mỗi thao tác thêm một class — nhiều class nhỏ.Every action adds a class — lots of small classes.
Undo đúng không dễ: phải lưu đủ trạng thái cũ, và thứ tự undo phải chuẩn.Correct undo is hard: you must save enough old state and undo in the right order.

Anti-pattern: lỗi thường gặpAnti-pattern: common mistake

Command 'béo' tự làm hết nghiệp vụFat command doing all the business logic

Command tự truy vấn DB, tính giá, gửi mail... thay vì nhờ receiver. Logic bị nhân bản qua nhiều command và không test riêng được. Command chỉ nên là 'tờ phiếu' gọi tới receiver/service.The command queries the DB, computes prices, sends mail... instead of delegating to a receiver. Logic gets duplicated across commands and can't be tested alone. A command should be a 'ticket' that calls a receiver/service.

public class ApplyVoucherCommand implements Command {
    public void execute() {
        // ❌ business logic copied into the command
        Voucher v = jdbc.queryForObject("SELECT ...", mapper, code);
        if (v.expiresAt().isBefore(Instant.now())) throw new VoucherExpired();
        BigDecimal discount = cart.total().multiply(v.rate());
        jdbc.update("UPDATE cart SET discount = ? ...", discount);
        mailer.send(cart.owner(), "Voucher applied!");
    }
    public void undo() { /* ❌ who knows how to reverse all that? */ }
}

Dễ nhầm vớiEasily confused with

Command vs Strategy

Strategy trả lời 'làm THẾ NÀO' (thuật toán thay được). Command trả lời 'làm CÁI GÌ' (một yêu cầu cụ thể kèm tham số, có thể lưu và undo).Strategy answers 'HOW to do it' (swappable algorithm). Command answers 'WHAT to do' (a concrete request with arguments that can be stored and undone).

Command vs Memento

Memento chụp toàn bộ trạng thái để khôi phục. Command lưu thao tác và tự biết cách đảo ngược nó — hai pattern hay đi cùng nhau.Memento snapshots the whole state to restore it. Command stores the action and knows how to reverse it — the two often work together.

Bài tập áp dụngExercise

Viết MacroCommand nhận một danh sách command: execute() chạy lần lượt, undo() hoàn tác theo thứ tự NGƯỢC LẠI. Dùng cho nút 'Mua lại đơn cũ' (thêm 3 món + áp voucher cùng lúc).Write a MacroCommand holding a list of commands: execute() runs them in order, undo() reverses them in REVERSE order. Use it for a 'Reorder' button (add 3 items + apply a voucher at once).

Kiểm tra kiến thứcKnowledge check

Câu 1 / 6Question 1 of 6

Ý tưởng cốt lõi của Command là gì?What is the core idea of Command?

Phím 1–4 để chọn đáp án, Enter để kiểm tra.Press 1–4 to choose an answer, Enter to check.

Thẻ ghi nhớFlashcards

Ôn tập ngắt quãng (spaced repetition): thẻ được lặp lại sau 1 → 3 → 7 → 14 → 30 ngày để củng cố trí nhớ dài hạn.Spaced repetition: cards are repeated after 1 → 3 → 7 → 14 → 30 days to build long-term memory.

Dùng trong bài toánUsed in problems

3 bài toán Backend dùng pattern này3 backend problems use this pattern

Pattern liên quanRelated patterns

Memento Strategy CQRS Worker Pool

Thảo luậnDiscussion

Commandaka Action, Transaction

Biến một yêu cầu thành object để lưu, xếp hàng, ghi log hoặc undo.Turn a request into an object so you can store, queue, log or undo it.

VừaMedium

Mức phổ biếnUsage 4/5

~9 phút đọc~9 min read

package com.shop.cart; /** A request wrapped as an object: it knows its receiver and its arguments. */ public interface Command {1 void execute(); /** Reverse exactly what execute() did */ void undo();2 default String label() {3 return getClass().getSimpleName(); } }

package cart import "context" // Command turns a request into a value you can store, queue or undo. type Command interface { Execute(ctx context.Context) error1 Undo(ctx context.Context) error } type ApplyVoucher struct { Cart *Cart // receiver Code string // argument previous string // saved for undo2 } func (c *ApplyVoucher) Execute(ctx context.Context) error {3 c.previous = c.Cart.Voucher return c.Cart.ApplyVoucher(ctx, c.Code) } func (c *ApplyVoucher) Undo(ctx context.Context) error { return c.Cart.ApplyVoucher(ctx, c.previous) }

public class ApplyVoucherCommand implements Command { public void execute() { // ❌ business logic copied into the command Voucher v = jdbc.queryForObject("SELECT ...", mapper, code); if (v.expiresAt().isBefore(Instant.now())) throw new VoucherExpired(); BigDecimal discount = cart.total().multiply(v.rate()); jdbc.update("UPDATE cart SET discount = ? ...", discount); mailer.send(cart.owner(), "Voucher applied!"); } public void undo() { /* ❌ who knows how to reverse all that? */ } }