设计模式：备忘录模式，优雅的备份数据

Dear 丶 2024-03-30 17:43 40阅读 0赞

**目录**

备忘录模式介绍

案例场景模拟

实战备忘录模式「配置文件回滚场景」

1.工程结构

1.1备忘录模式模型结构

2.代码实现

2.1 配置信息类

2.2 备忘录类

2.3 记录者类

2.4 管理员类

3. 测试验证

3.1 编写测试类

3.2 测试结果

总结

--------------------

## 备忘录模式介绍 ##

![f2551bac68914597a004058ef6d260a7.png][]

图片来自：[备忘录设计模式][Link 1]

备忘录模式是以可以恢复或者说回滚，配置、版本、悔棋为核心功能的设计模式，而这种设计模式属于行为模式。在功能实现上是以不破坏原对象为基础增加备忘录操作类，记录原对象的行为从而实现备忘录模式。

这个设计在我们平常的生活或者开发中也是比较常见的，比如：后悔药、孟婆汤(一下回滚到0)，IDEA编辑和撤销、小霸王游戏机存档。当然还有我们非常常见历史头像，如下；

![dc675d7407024560aff464c3848deffa.png][]

## 案例场景模拟 ##

![a8d2eb5ed67f469cb0775784125a1be3.png][]

**在本案例中我们模拟系统在发布上线的过程中记录线上配置文件用于紧急回滚**

在大型互联网公司系统的发布上线一定是易用、安全、可处理紧急状况的，同时为了可以隔离线上和本地环境，一般会把配置文件抽取出来放到线上，避免有人误操作导致本地的配置内容发布出去。同时线上的配置文件也会在每次变更的时候进行记录，包括；版本号、时间、MD5、内容信息和操作人。

在后续上线时如果发现紧急问题，系统就会需要回滚操作，如果执行回滚那么也可以设置配置文件是否回滚。因为每一个版本的系统可能会随着带着一些配置文件的信息，这个时候就可以很方便的让系统与配置文件一起回滚操作。

我们接下来就使用备忘录模式，模拟如何记录配置文件信息。实际的使用过程中还会将信息存放到库中进行保存，这里暂时只是使用内存记录

## 实战备忘录模式「配置文件回滚场景」 ##

备忘录的设计模式实现方式，重点在于不更改原有类的基础上，增加备忘录类存放记录。可能平时虽然不一定非得按照这个设计模式的代码结构来实现自己的需求，但是对于功能上可能也完成过类似的功能，记录系统的信息。

除了现在的这个案例外，还可以是运营人员在后台erp创建活动对信息的记录，方便运营人员可以上下修改自己的版本，而不至于因为误操作而丢失信息。

### 1.工程结构 ###

cn-lasse-momento
    └── src
        ├── main
        │   └── java
        │       └── cn-lasse.design
        │           ├── Admin.java
        │           ├── ConfigFile.java
        │           ├── ConfigMemento.java
        │           └── ConfigOriginator.java
        └── test
            └── java
                └── cn-lasse.design
                    └── ApiTest.java

#### 1.1**备忘录模式模型结构** ####

![b3efd9cf032f49c8b0d3c07385fefdda.png][]

以上是工程结构的一个类图，其实相对来说并不复杂，除了原有的配置类(`ConfigFile`)以外，只新增加了三个类。

*  `ConfigMemento`：备忘录类，相当于是对原有配置类的扩展
 *  `ConfigOriginator`：记录者类，获取和返回备忘录类对象信息
 *  `Admin`：管理员类，用于操作记录备忘信息，比如你一些列的顺序执行了什么或者某个版本下的内容信息

### 2.代码实现 ###

#### 2.1 配置信息类 ####

@Data
    @AllArgsConstructor
    public class ConfigFile {
        private String versionNo; // 版本号
        private String content;   // 内容
        private Date dateTime;    // 时间
        private String operator;  // 操作人
    }

*      配置类可以是任何形式的，这里只是简单的描述了一个基本的配置内容信息

#### 2.2 备忘录类 ####

@Data
    @AllArgsConstructor
    public class ConfigMemento {
        private ConfigFile configFile;
    
        private Date mementoDate;
        //...额外信息
    
        public ConfigMemento (ConfigFile configFile){
            this.configFile=configFile;
            this.mementoDate=new Date();
        }
    }

*  备忘录是对原有配置类的扩展，可以设置和获取配置信息。

#### 2.3 记录者类 ####

@Getter
    @Setter
    public class ConfigOriginator {
        private ConfigFile configFile;
    
        /**
         * 保存备忘录的时候会创建一个备忘录信息，并返回回去，交给管理者处理。
         */
        public ConfigMemento saveMemento(){
            return new ConfigMemento(configFile);
        }
    
        /**
         * 获取的之后并不是直接返回，而是把备忘录的信息交给现在的配置文件this.configFile，这部分需要注意
         */
        public void getMemento(ConfigMemento memento){
            this.configFile = memento.getConfigFile();
        }
    }

*  记录者类除了对`ConfigFile`配置类增加了获取和设置方法外，还增加了保存`saveMemento()`、获取`getMemento(ConfigMemento memento)`。

#### 2.4 管理员类 ####

public class Admin {
        private int cursorIdx = -1;
        private List<ConfigMemento> mementoList = new ArrayList<>();
        private Map<String, ConfigMemento> mementoMap = new ConcurrentHashMap<>();
    
        /**
         * 存放
         */
        public void append(ConfigMemento memento) {
            cursorIdx++;
            mementoList.add(memento);
            mementoMap.put(memento.getConfigFile().getVersionNo(), memento);
        }
    
        /**
         * 回滚
         */
        public ConfigMemento undo() {
            if (--cursorIdx <= 0) {
                return mementoList.get(0);
            }
            return mementoList.get(cursorIdx);
        }
    
        /**
         * 返回
         */
        public ConfigMemento redo() {
            if (++cursorIdx > mementoList.size()) {
                return mementoList.get(mementoList.size() - 1);
            }
            return mementoList.get(cursorIdx);
        }
    
        /**
         * 定向获取
         */
        public ConfigMemento get(String versionNo){
            return mementoMap.get(versionNo);
        }
    }

*  在这个类中主要实现的核心功能就是记录配置文件信息，也就是备忘录的效果，之后提供可以回滚和获取的方法，拿到备忘录的具体内容。
 *  同时这里设置了两个数据结构来存放备忘录，实际使用中可以按需设置。`List<ConfigMemento>`、`Map<String, ConfigMemento>`。
 *  最后是提供的备忘录操作方法；存放(`append`)、回滚(`undo`)、返回(`redo`)、定向获取(`get`)，这样四个操作方法。

### 3. 测试验证 ###

#### 3.1 编写测试类 ####

@Slf4j
    public class ApiTest {
        @Test
        public void test() {
            Admin admin = new Admin();
            ConfigOriginator configOriginator = new ConfigOriginator();
            //1
            configOriginator.setConfigFile(new ConfigFile("1", "嘿嘿", new Date(), "Lasse"));
            admin.append(configOriginator.saveMemento()); // 保存配置
            //2
            configOriginator.setConfigFile(new ConfigFile("2", "嘻嘻", new Date(), "Lasse"));
            admin.append(configOriginator.saveMemento()); // 保存配置
            //3
            configOriginator.setConfigFile(new ConfigFile("3", "么么", new Date(), "Lasse"));
            admin.append(configOriginator.saveMemento()); // 保存配置
    
            log.info("当前配置：{}", JSON.toJSONString(configOriginator.getConfigFile()));
    
            // 历史配置(回滚)
            configOriginator.getMemento(admin.undo());
            log.info("历史配置(回滚)undo：{}", JSON.toJSONString(configOriginator.getConfigFile()));
    
            // 历史配置(回滚)
            configOriginator.getMemento(admin.undo());
            log.info("历史配置(再回滚)undo：{}", JSON.toJSONString(configOriginator.getConfigFile()));
    
            // 历史配置(前进)
            configOriginator.getMemento(admin.redo());
            log.info("历史配置(前进)redo：{}", JSON.toJSONString(configOriginator.getConfigFile()));
    
            // 历史配置(获取)
            configOriginator.getMemento(admin.get("2"));
            log.info("历史配置(定点获取)get：{}", JSON.toJSONString(configOriginator.getConfigFile()));
        }
    }

*  这个设计模式的学习有一部分重点是体现在了单元测试类上，这里包括了四次的信息存储和备忘录历史配置操作。
 *  通过上面添加了四次配置后，下面分别进行操作是；`回滚1次`、`再回滚1次`，`之后向前进1次`，`最后是获取指定的版本配置`。具体的效果可以参考测试结果。

#### 3.2 测试结果 ####

10:22:11.447 [main] INFO cn.lasse.design.ApiTest - 当前配置：{"content":"么么","dateTime":1673490131295,"operator":"Lasse","versionNo":"3"}
    10:22:11.454 [main] INFO cn.lasse.design.ApiTest - 历史配置(回滚)undo：{"content":"嘻嘻","dateTime":1673490131295,"operator":"Lasse","versionNo":"2"}
    10:22:11.454 [main] INFO cn.lasse.design.ApiTest - 历史配置(再回滚)undo：{"content":"嘿嘿","dateTime":1673490131294,"operator":"Lasse","versionNo":"1"}
    10:22:11.454 [main] INFO cn.lasse.design.ApiTest - 历史配置(前进)redo：{"content":"嘻嘻","dateTime":1673490131295,"operator":"Lasse","versionNo":"2"}
    10:22:11.454 [main] INFO cn.lasse.design.ApiTest - 历史配置(定点获取)get：{"content":"嘻嘻","dateTime":1673490131295,"operator":"Lasse","versionNo":"2"}

*  从测试效果上可以看到，历史配置按照我们的指令进行了回滚和前进，以及最终通过指定的版本进行获取，符合预期结果。

## 总结 ##

*  此种设计模式的方式可以满足在不破坏原有属性类的基础上，扩充了备忘录的功能。虽然和我们平时使用的思路是一样的，但在具体实现上还可以细细品味，这样的方式在一些源码中也有所体现。
 *  在以上的实现中我们是将配置模拟存放到内存中，如果关机了会导致配置信息丢失，因为在一些真实的场景里还是需要存放到数据库中。那么此种存放到内存中进行回复的场景也不是没有，比如；Photoshop、运营人员操作ERP配置活动，那么也就是即时性的一般不需要存放到库中进行恢复。另外如果是使用内存方式存放备忘录，需要考虑存储问题，避免造成内存大量消耗。
 *  设计模式的学习都是为了更好的写出可扩展、可管理、易维护的代码，而这个学习的过程需要自己不断的尝试实际操作，理论的知识与实际结合还有很长一段距离。切记多多上手！

## 源码地址 ##

[lasse-designPattern: 学习设计模式][lasse-designPattern_]

[f2551bac68914597a004058ef6d260a7.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/97d4d9e62abf46c9b610ec8646dbc5d0.png
[Link 1]: https://refactoringguru.cn/design-patterns/memento
[dc675d7407024560aff464c3848deffa.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/83bd9d16a69f42b58311dcdec94d13f8.png
[a8d2eb5ed67f469cb0775784125a1be3.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/1a10bb8b76b246b392c1a7eb30eb6e22.png
[b3efd9cf032f49c8b0d3c07385fefdda.png]: https://image.dandelioncloud.cn/pgy_files/images/2024/03/30/876f190583b2475686483d6db878530a.png
[lasse-designPattern_]: https://gitee.com/luosuichuan/lasse-design-pattern