架构与系统设计 / 系统课时
命令模式封装可执行操作
命令模式封装可执行操作
当业务开始出现排队执行、撤销、重试或审计需求时,直接调用服务方法会把“谁发起请求”和“如何执行请求”绑在一起。命令模式把一次操作及其必要参数封装成对象,让调用方只负责提交命令,执行细节由命令和接收者协作完成。
学习目标
- 识别命令模式中调用者、命令对象与接收者的职责边界
- 用可执行命令实现统一执行与撤销入口
- 判断队列、重试和审计场景中命令对象还需要补哪些业务约束
请求为什么要变成对象
普通调用通常是 controller -> service.method(args)。当需求只是“现在执行一次”时,这最直接;但一旦要把操作暂存到队列、记录历史、延迟执行或撤销,就需要额外保存方法名、参数和执行上下文,调用链很快会出现大量条件分支。
命令模式把这些信息收进一个实现统一接口的对象。调用者只认识 execute(),接收者负责真正修改业务状态。这样,队列可以存放命令对象,历史记录可以保存已经执行的命令,审计也能围绕同一种抽象记录。

关键边界是:命令对象描述“要做什么”,接收者实现“具体怎么做”,调用者决定“什么时候做”。如果命令自己包含大量领域逻辑,它就会逐渐替代接收者,反而让职责重新混在一起。
用一个可撤销命令落地
下面示例使用 Java 17。AppendCommand 在执行前记录文本长度,因此撤销时可以恢复到执行前状态;调用者 CommandHistory 不需要知道文本是如何修改的。
import java.util.ArrayDeque;
import java.util.Deque;
public class Main {
interface Command {
void execute();
void undo();
}
static final class TextBuffer {
private final StringBuilder value = new StringBuilder();
void append(String text) {
value.append(text);
}
void truncate(int length) {
value.setLength(length);
}
String content() {
return value.toString();
}
}
static final class AppendCommand implements Command {
private final TextBuffer receiver;
private final String text;
private int previousLength;
AppendCommand(TextBuffer receiver, String text) {
this.receiver = receiver;
this.text = text;
}
@Override
public void execute() {
previousLength = receiver.content().length();
receiver.append(text);
}
@Override
public void undo() {
receiver.truncate(previousLength);
}
}
static final class CommandHistory {
private final Deque<Command> history = new ArrayDeque<>();
void run(Command command) {
command.execute();
history.push(command);
}
void undoLast() {
Command command = history.poll();
if (command != null) {
command.undo();
}
}
}
public static void main(String[] args) {
TextBuffer buffer = new TextBuffer();
CommandHistory history = new CommandHistory();
history.run(new AppendCommand(buffer, "A"));
history.run(new AppendCommand(buffer, "B"));
System.out.println(buffer.content());
history.undoLast();
System.out.println(buffer.content());
}
}预期输出
AB
A这里真正让撤销可行的不是 undo() 这个方法名,而是命令保存了足以恢复状态的信息。对于转账、发货等不可简单逆转的操作,通常需要定义“补偿命令”,而不是假装能把外部世界恢复到原样。
队列、重试和审计要补什么
命令对象天然适合被队列保存,但“能入队”不等于“可以安全重试”。跨进程执行时,命令还需要稳定的类型标识、可序列化参数和唯一请求 ID;接收端则需要幂等控制,避免超时重发导致重复扣款或重复创建资源。
审计也不应只记录类名。至少要能关联命令 ID、发起者、目标对象、执行结果和时间。若命令参数包含密码、令牌或隐私数据,应在记录前做脱敏。
什么时候值得使用
当系统确实需要延迟执行、批处理、操作历史、统一重试或可插拔执行策略时,命令模式能显著降低调用者与执行逻辑的耦合。若业务只是一次简单同步调用,没有排队、撤销或记录需求,直接调用服务方法通常更清楚,没必要为了“模式完整”额外创建一组命令类。