架构与系统设计 / 系统课时

命令模式封装可执行操作

命令模式封装可执行操作

当业务开始出现排队执行、撤销、重试或审计需求时,直接调用服务方法会把“谁发起请求”和“如何执行请求”绑在一起。命令模式把一次操作及其必要参数封装成对象,让调用方只负责提交命令,执行细节由命令和接收者协作完成。

学习目标

  • 识别命令模式中调用者、命令对象与接收者的职责边界
  • 用可执行命令实现统一执行与撤销入口
  • 判断队列、重试和审计场景中命令对象还需要补哪些业务约束

请求为什么要变成对象

普通调用通常是 controller -> service.method(args)。当需求只是“现在执行一次”时,这最直接;但一旦要把操作暂存到队列、记录历史、延迟执行或撤销,就需要额外保存方法名、参数和执行上下文,调用链很快会出现大量条件分支。

命令模式把这些信息收进一个实现统一接口的对象。调用者只认识 execute(),接收者负责真正修改业务状态。这样,队列可以存放命令对象,历史记录可以保存已经执行的命令,审计也能围绕同一种抽象记录。

命令模式的调用、执行与历史关系

关键边界是:命令对象描述“要做什么”,接收者实现“具体怎么做”,调用者决定“什么时候做”。如果命令自己包含大量领域逻辑,它就会逐渐替代接收者,反而让职责重新混在一起。

用一个可撤销命令落地

下面示例使用 Java 17。AppendCommand 在执行前记录文本长度,因此撤销时可以恢复到执行前状态;调用者 CommandHistory 不需要知道文本是如何修改的。

java
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());
    }
}

预期输出

text
AB
A

这里真正让撤销可行的不是 undo() 这个方法名,而是命令保存了足以恢复状态的信息。对于转账、发货等不可简单逆转的操作,通常需要定义“补偿命令”,而不是假装能把外部世界恢复到原样。

队列、重试和审计要补什么

命令对象天然适合被队列保存,但“能入队”不等于“可以安全重试”。跨进程执行时,命令还需要稳定的类型标识、可序列化参数和唯一请求 ID;接收端则需要幂等控制,避免超时重发导致重复扣款或重复创建资源。

审计也不应只记录类名。至少要能关联命令 ID、发起者、目标对象、执行结果和时间。若命令参数包含密码、令牌或隐私数据,应在记录前做脱敏。

什么时候值得使用

当系统确实需要延迟执行、批处理、操作历史、统一重试或可插拔执行策略时,命令模式能显著降低调用者与执行逻辑的耦合。若业务只是一次简单同步调用,没有排队、撤销或记录需求,直接调用服务方法通常更清楚,没必要为了“模式完整”额外创建一组命令类。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

命令模式封装可执行操作

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通