一、备忘录模式介绍
1. 解决的问题
主要解决在不破坏封装性的前提下,捕获一个对象的内部状态,并在该对象之外保存这个状态,从而可以恢复原先保存的状态。
2. 定义
备忘录模式是一种行为设计模式,允许在不暴露对象实现细节的状态下保存和恢复对象之前的状态。
3. 应用场景
- 当你需要创建对象状态快照来恢复其之前的状态时,可以使用备忘录模式。
- 当直接访问对象的成员变量、获取器或设置器将导致封装被突破时,可以使用备忘录模式。
二、备忘录模式优缺点
1. 优点
- 可以在不破坏对象封装情况的前提下创建对象状态快照。
- 可以通过让负责人维护原发器状态历史记录来简化原发器代码。
2. 缺点
- 如果客户端过于频繁地创建备忘录,程序将消耗大量内存。
- 负责人必须完整跟踪原发器的生命周期,这样才能销毁弃用的备忘录。
- 绝大部分动态编程语言(例如PHP、Python 和 JavaScript)不能确保备忘录中的状态不被修改。
三、备忘录模式应用实例:线上刚发布就出问题怎么办?
1. 实例场景
搬砖的我们经常会遇到这个情况:
老代码出了 bug ,先看文档手册,我去,这代码连个文档都没有,只能看源码了。
看完一遍逻辑,再调试个半天,应该是这里出问题了,快速修改完毕,验证一遍,nice,没什么问题。
开始联系测试验证,测试环境验证通过!
激动人心的时刻来了:提交代码合并请求 -> 编译 -> 发布。
哎,怎么回事,线上发布的容器疯狂报错,起都起不来,我的天,怎么办?
旁边的同事:别慌,先把发布回滚吧,保证线上没问题!
今天,我们就以发布回滚为例,介绍一下备忘录模式。
2. 备忘录模式实现
2.1 工程结构
└─ src
├─ main
│ └─ java
│ └─ org.design.pattern.memento
│ └─ model
│ ├─ ReleaseRecord.java
│ ├─ ReleaseRecordOriginator.java
│ ├─ ReleaseRecordMemento.java
│ └─ ReleaseRecordCaretaker.javaa
└─ test
└─ java
└─ org.design.pattern.memento
└─ MementoTest.java
2.2 代码实现
2.2.1 实体类
发布记录
/**
* 发布记录
*/
@Getter
@Setter
@AllArgsConstructor
public class ReleaseRecord {
/**
* 发布记录号
*/
private Integer id;
/**
* 发布版本
*/
private String version;
/**
* 发布容器
*/
private String cloudName;
/**
* 开发
*/
private String developerName;
/**
* 测试
*/
private String testerName;
}
2.2.2 备忘录模式相关类
发布记录原生器
/**
* 发布记录原生器
*/
@Getter
@Setter
public class ReleaseRecordOriginator {
/**
* 发布记录
*/
private ReleaseRecord releaseRecord;
/**
* 构造函数
*
* @param releaseRecord 发布记录
*/
public ReleaseRecordOriginator(ReleaseRecord releaseRecord) {
this.releaseRecord = releaseRecord;
}
/**
* 保存发布记录
*
* @return ReleaseRecordMemento
*/
public ReleaseRecordMemento save() {
return new ReleaseRecordMemento(this.releaseRecord);
}
/**
* 恢复发布记录
*
* @param releaseRecordMemento 发布记录备忘录
*/
public void restore(ReleaseRecordMemento releaseRecordMemento) {
this.releaseRecord = releaseRecordMemento.getReleaseRecord();
}
}
发布记录备忘录
/**
* 发布记录备忘录
*/
@Getter
@Setter
public class ReleaseRecordMemento {
/**
* 发布记录
*/
private ReleaseRecord releaseRecord;
/**
* 构造函数
*
* @param releaseRecord 发布记录
*/
public ReleaseRecordMemento(ReleaseRecord releaseRecord) {
this.releaseRecord = releaseRecord;
}
}
发布记录负责人
/**
* 发布记录负责人
*/
public class ReleaseRecordCaretaker {
/**
* 发布记录历史记录列表
*/
private List<ReleaseRecordMemento> mementoList = new ArrayList<>();
/**
* 发布历史记录map(可根据发布记录id查询)
*/
private Map<Integer, ReleaseRecordMemento> mementoMap = new HashMap<>();
/**
* 存放发布记录
*
* @param releaseRecordMemento 发布记录备忘录
*/
public void push(ReleaseRecordMemento releaseRecordMemento) {
mementoList.add(releaseRecordMemento);
mementoMap.put(releaseRecordMemento.getReleaseRecord().getId(), releaseRecordMemento);
}
/**
* 回滚
*
* @return ReleaseRecordMemento
*/
public ReleaseRecordMemento undo() {
if (ObjectUtils.isEmpty(mementoList)) {
return null;
}
return mementoList.get(mementoList.size() - 1);
}
/**
* 根据发布记录id回滚
*
* @param releaseRecordId 发布记录id
* @return ReleaseRecordMemento
*/
public ReleaseRecordMemento undo(Integer releaseRecordId) {
if (ObjectUtils.isEmpty(mementoMap) || ObjectUtils.isEmpty(mementoMap.get(releaseRecordId))) {
return null;
}
return mementoMap.get(releaseRecordId);
}
}
2.3 测试验证
2.3.1 测试验证类
/***
* 备忘录模式测试
*/
@Slf4j
public class MementoTest {
@Test
public void test() {
ReleaseRecordCaretaker recordCaretaker = new ReleaseRecordCaretaker();
ReleaseRecordOriginator recordOriginator = new ReleaseRecordOriginator(
new ReleaseRecord(1, "0.1.0", "test-cloud", "yiyu", "tester")
);
recordCaretaker.push(recordOriginator.save());
recordOriginator.setReleaseRecord(
new ReleaseRecord(2, "0.1.1", "test-cloud", "yiyu", "tester")
);
recordCaretaker.push(recordOriginator.save());
// 回滚
recordOriginator.restore(recordCaretaker.undo());
log.info("历史发布回滚:{}", JSON.toJSONString(recordOriginator.getReleaseRecord()));
// 根据发布id回滚
Integer undoReleaseRecordId = 1;
recordOriginator.restore(recordCaretaker.undo(undoReleaseRecordId));
log.info("回滚发布记录id为{}的发布:{}", undoReleaseRecordId, JSON.toJSONString(recordOriginator.getReleaseRecord()));
}
}
2.3.2 测试结果
22:36:44.731 [main] INFO o.d.pattern.memento.test.MementoTest - 历史发布回滚:{"cloudName":"test-cloud","developerName":"yiyu","id":2,"testerName":"tester","version":"0.1.1"}
22:36:44.733 [main] INFO o.d.pattern.memento.test.MementoTest - 回滚发布记录id为1的发布:{"cloudName":"test-cloud","developerName":"yiyu","id":1,"testerName":"tester","version":"0.1.0"}
Process finished with exit code 0
四、备忘录模式结构
-
原发器(Originator)类可以生成自身状态的快照,也可以在需要时通过快照恢复自身状态。
-
备忘录(Memento)是原发器状态快照的值对象(value object)。通常做法是将备忘录设为不可变的,并通过构造函数一次性传递数据。
-
负责人(Caretaker)仅知道 “何时” 和 “为何” 捕捉原发器的状态,以及何时恢复状态。
负责人通过保存备忘录栈来记录原发器的历史状态。当原发器需要回溯历史状态时,负责人将栈中获取最顶部的备忘录,并将其传递给原发器的恢复(restoration)方法。
-
在实现方法中,备忘录类将被嵌套在原发器中。这样原发器就可以访问备忘录的成员变量和方法,即使这些方法被声明为私有。另一方面,负责人对于备忘录的成员变量和方法的访问权限非常有限:它们只能栈中保存备忘录,而不能修改其状态。
设计模式并不难学,其本身就是多年经验提炼出的开发指导思想,关键在于多加练习,带着使用设计模式的思想去优化代码,就能构建出更合理的代码。
源码地址:https://github.com/yiyufxst/design-pattern-java
参考资料:
小博哥重学设计模式:https://github.com/fuzhengwei/itstack-demo-design
深入设计模式:[https://refactoringguru.cn/design-patterns/catalog](