【一起学系列】之命令模式：封装一个简单Jedis

朴灿烈づ我的快乐病毒、 2023-02-14 10:11 14阅读 0赞

## 意图 ##

将一个请求封装为一个对象，从而使你可用不同的请求对客户进行参数化；对请求排队或记录请求日志，以及支持可撤销的操作。

## 命令模式的诞生 ##

【产品】：开发小哥，来活啦，咱们需要设计一款遥控器，核心功能就是几个按键，但是可能要控制很多不同品牌的设备，你们构思构思吧~

【开发】：按键？不存在的，对我来说就是请求罢了，Boss，帮我想一下怎么适配不同的品牌的设备啊？

【BOSS】：适配设备这个事，仅仅靠我们是不行的，这都是配合的结果，你既然也说了什么按钮只不过是请求而已，那可以考虑使用命令模式，把请求封装为对象，由我们主动去绑定不同品牌对应的执行者，懂了吗？

【开发】：哈？哦，懂了懂了（我懂个鬼！）

![format_png][]

## HeadFirst 核心代码 ##

**父级接口**

public interface Command { 
        void execute();
    }

**封装请求为一个对象**

public class LightOnCommand implements Command { 
    
        Light light;
    
        public LightOnCommand(Light light) { 
            this.light = light;
        }
    
        @Override
        public void execute() { 
            light.on();
        }
    }

**请求响应的Api**

public class Light { 
    
        /*** * on方法 */
        public void on() { 
            System.out.println("On...");
        }
    
        /*** * off方法 */
        public void off() { 
            System.out.println("Off...");
        }
    }

**调用方代码**

public class SimpleRemoteControl { 
    
        Command slot;
    
        public SimpleRemoteControl() { }
    
        public void setCommand(Command command) { 
            slot = command;
        }
    
        public void buttonWasPressed() { 
            slot.execute();
        }
    }
    
    //******************************************
    
    public static void main(String[] args) { 
        SimpleRemoteControl remote = new SimpleRemoteControl();
    
        Light light = new Light();
    
        LightOnCommand lightOn = new LightOnCommand(light);
        remote.setCommand(lightOn);
        remote.buttonWasPressed();
    
        LightOffCommand lightOff = new LightOffCommand(light);
        remote.setCommand(lightOff);
        remote.buttonWasPressed();
    }

命令模式的设计思路：

*  Command 声明命令的接口
 *  ConcreteCommand 具体的动作 | 命令
 *  Client 客户端请求
 *  Invoker 绑定命令与接收者
 *  Receiver 接收者 知道如何实施与执行一个请求相关的操作，任何类都可以是接收者

代码的核心即：把请求抽象为一个命令，把执行命令的接收者和命令本身分离，交由第三方类（Invoker）去管理，达到解耦的目的

## 试试用命令模式封装简单Jedis ##

### Redis协议Tips ###

Redis 即 REmote Dictionary Server (远程字典服务)；

而Redis的协议规范是 Redis Serialization Protocol (Redis序列化协议)

RESP 是redis客户端和服务端之前使用的一种通讯协议；

RESP 的特点：实现简单、快速解析、可读性好

协议如下：

客户端以规定格式的形式发送命令给服务器

set key value 协议翻译如下：
    
    * 3    ->  表示以下有几组命令
    
    $ 3    ->  表示命令长度是3
    SET
    
    $6     ->  表示长度是6
    keykey
    
    $5     ->  表示长度是5
    value
    
    完整即：
    * 3
    $ 3
    SET
    $6
    keykey
    $5 
    value

> 关于Redis相关的RESP协议，我在之后的文章会专门出一篇讲解~

### 封装Get命令 ###

public class GetCommand implements Command { 
    
        private GetReceiver receiver;
    
        private String arg;
    
        @Override
        public void execute() { 
            receiver.doCommand(this.arg);
        }
    
        public GetCommand(GetReceiver receiver, String arg) { 
            this.receiver = receiver;
            this.arg = arg;
        }
    }

### 封装Get接收者 ###

public class GetReceiver { 
    
        OutputStream write;
    
        InputStream read;
    
        public void doCommand (String arg) { 
            String[] strings = arg.split(" ");
            String key = strings[0];
            byte[] bytes;
            try { 
                String sb = "*2" + SPILT +
                        "$3" + SPILT +
                        "GET" + SPILT +
                        "$" + key.getBytes().length + SPILT +
                        key + SPILT;
                write.write(sb.getBytes());
                bytes = new byte[1024];
                read.read(bytes);
                System.out.println("Result: " + new String(bytes));
            } catch (IOException e) { 
                e.printStackTrace();
            }
        }
    
        public GetReceiver(OutputStream write, InputStream read) { 
            this.write = write;
            this.read = read;
        }
    
        final String SPILT = "\r\n";
    }

### 封装Invoker ###

利用栈存储命令，可以很好的控制命令的变化等等

public class Invoker { 
    
        private final Stack<Command> commands;
    
        public Invoker() { 
            commands = new Stack<>();
        }
    
        public void addCommand(Command command) { 
            commands.push(command);
        }
    
        public void undoCommand() { 
            if (!commands.empty()) { 
                commands.pop();
            }
        }
    
        public void execute() { 
            while (!commands.empty()) { 
                Command command = commands.pop();
                command.execute();
            }
        }
    }

### 测试类 ###

/*** * 简易Jedis代码, 利用栈存储命令(可根据需求更改数据结构) * * 推荐阅读顺序： * @see Command * @see GetCommand | SetCommand * @see GetReceiver | SetReceiver * @see Invoker */
        public static void main(String[] args) throws IOException { 
            // 初始化Socket流
            Socket socket = new Socket("127.0.0.1", 6379);
            OutputStream write = socket.getOutputStream();
            InputStream read = socket.getInputStream();
    
            Invoker invoker = new Invoker();
    
            // 初始化Get | Set任务执行者
            GetReceiver getReceiver = new GetReceiver(write, read);
            SetReceiver setReceiver = new SetReceiver(write, read);
    
            // 测试get命令
            invoker.addCommand(new GetCommand(getReceiver, "key"));
    
            // 测试set命令
            invoker.addCommand(new SetCommand(setReceiver, "key xixixi"));
    
            // 测试get命令
            invoker.addCommand(new GetCommand(getReceiver, "key"));
    
            // 测试get命令
            invoker.addCommand(new GetCommand(getReceiver, "key"));
    
            // 测试撤销上一个命令 -> 输出四次则测试失败，三次则成功
            invoker.undoCommand();
            invoker.execute();
        }

输出结果：

Result: $4
    test
    
    Result: +OK
    
    Result: $6
    xixixi
    
    // 测试成功~

> 代码量有点小多，需要看详情的话，请跳转到最下面的相关代码链接吧~

## 什么场景适用 ##

在下列情况下可以使用 Command Method模式：

*  需要抽象出待执行的动作以参数化某对象
 *  在不同的时刻指定，排列和执行请求
 *  支持取消操作

## Code/生活中的实际应用 ##

在日常生活中都有订单的概念，为什么我们下订单，服务员或者其他工作人员完全明白我们的意图呢？就是因为我们按照他们制定的规则构建起了一个命令，那么在交互过程就不需要层层沟通，方便解耦。

## UML图 ##

![format_png 1][]

## 遵循的设计原则 ##

*  针对接口编程，不针对实现编程
 *  为交互对象松耦合设计而努力
 *  类应该对拓展开放，对修改关闭

## 相关代码链接 ##

[GitHub地址][GitHub]

*  兼顾了《HeadFirst》以及《GOF》两本经典书籍中的案例
 *  提供了友好的阅读指导

![format_png 2][]

[format_png]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91c2VyLWdvbGQtY2RuLnhpdHUuaW8vMjAyMC82LzEvMTcyNzA5M2RlOGUyMGJlNg?x-oss-process=image/format,png
[format_png 1]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91c2VyLWdvbGQtY2RuLnhpdHUuaW8vMjAyMC82LzEvMTcyNzA5NDE3ZTYyMjRmNA?x-oss-process=image/format,png
[GitHub]: https://github.com/kkzhilu/Kerwin-DesignPattern
[format_png 2]: https://imgconvert.csdnimg.cn/aHR0cHM6Ly91c2VyLWdvbGQtY2RuLnhpdHUuaW8vMjAyMC82LzEvMTcyNzA5NDNiN2M1MDIyYg?x-oss-process=image/format,png