「补课」进行时：设计模式(17)——备忘录模式
1. 前文汇总
2. 从版本控制开始
相信每个程序猿，每天工作都会使用版本控制工具，不管是微软提供的 vss 还是 tfs ，又或者是开源的 svn 或者 git ，每天下班前，总归会使用版本控制工具提交一版代码。
版本管理工具是让我们在代码出问题的时候，可以方便的获取到之前的版本进行版本回退，尤其是在项目发布投运的时候，当出现问题的时候直接获取上一个版本进行回滚操作。
在这个操作中间，最重要的就是保存之前的状态，那么如何保存之前的状态？
操作很简单，我们可以定义一个中间变量，保留这个原始状态。
先定义一个版本管理 Git 类：
public class Git {
private String state;
// 版本发生改变，现在是 version2
public void changeState() {
this.state = "version2";
}
public String getState() {
return state;
}
public void setState(String state) {
this.state = state;
}
}
然后是一个场景 Client 类：
public class Client {
public static void main(String[] args) {
Git git = new Git();
// 初始化版本
git.setState("version1");
System.out.println("当前的版本信息：");
System.out.println(git.getState());
// 记录下当前的状态
Git backup = new Git();
backup.setState(git.getState());
// 提交一个版本，版本进行改变
git.changeState();
System.out.println("提交一个版本后的版本信息：");
System.out.println(git.getState());
// 回退一个版本，版本信息回滚
git.setState(backup.getState());
System.out.println("回退一个版本后的版本信息：");
System.out.println(git.getState());
}
}
执行结果：
当前的版本信息：
version1
提交一个版本后的版本信息：
version2
回退一个版本后的版本信息：
version1
程序运行正确，输出结果也是我们期望的，但是结果正确并不表示程序是合适的。
在场景类 Client 类中，这个是高层模块，现在却在高层模块中做了中间临时变量 backup 的状态的保持，为什么一个状态的保存和恢复要让高层模块来负责呢？
这个中间临时变量 backup 应该是 Git 类的职责，而不是让一个高层次的模块来进行定义。
我们新建一个 Memento 类，用作负责状态的保存和备份。
public class Memento {
private String state;
public Memento(String state) {
this.state = state;
}
public String getState() {
return state;
}
public void setState(String state) {
this.state = state;
}
}
新建一个 Memento ，用构造函数来传递状态 state ，修改上面的 Git 类，新增两个方法 createMemento() 和 restoreMemento()，用来创建备忘录以及恢复一个备忘录。
public class Git {
private String state;
// 版本发生改变，现在是 version2
public void changeState() {
this.state = "version2";
}
public String getState() {
return state;
}
public void setState(String state) {
this.state = state;
}
// 创建一个备忘录
public Memento createMemento(String state) {
return new Memento(state);
}
// 恢复一个备忘录
public void restoreMemento(Memento memento) {
this.setState(memento.getState());
}
}
修改后的场景类：
public class Client {
public static void main(String[] args) {
Git git = new Git();
// 初始化版本
git.setState("version1");
System.out.println("当前的版本信息：");
System.out.println(git.getState());
// 记录下当前的状态
Memento mem = git.createMemento(git.getState());
// 提交一个版本，版本进行改变
git.changeState();
System.out.println("提交一个版本后的版本信息：");
System.out.println(git.getState());
// 项目发布失败，回滚状态
git.restoreMemento(mem);
System.out.println("回退一个版本后的版本信息：");
System.out.println(git.getState());
}
}
运行结果和之前的案例保持一致，那么这就结束了么，当然没有，虽然我们在 Client 中不再需要重复定义 Git 类了，但是这是对迪米特法则的一个亵渎，它告诉我们只和朋友类通信，那这个备忘录对象是我们必须要通信的朋友类吗？对高层模块来说，它最希望要做的就是创建一个备份点，然后在需要的时候再恢复到这个备份点就成了，它不用关心到底有没有备忘录这个类。
那我们可以对这个备忘录的类再做一下包装，创建一个管理类，专门用作管理这个备忘录：
public class Caretaker {
private Memento memento;
public Memento getMemento() {
return memento;
}
public void setMemento(Memento memento) {
this.memento = memento;
}
}
非常简单纯粹的一个 JavaBean ，甭管它多简单，只要有用就成，我们来看场景类如何调用：
public class Client {
public static void main(String[] args) {
Git git = new Git();
// 创建一个备忘录管理者
Caretaker caretaker = new Caretaker();
// 初始化版本
git.setState("version1");
System.out.println("当前的版本信息：");
System.out.println(git.getState());
// 记录下当前的状态
caretaker.setMemento(git.createMemento(git.getState()));
// 提交一个版本，版本进行改变
git.changeState();
System.out.println("提交一个版本后的版本信息：");
System.out.println(git.getState());
// 项目发布失败，回滚状态
git.restoreMemento(caretaker.getMemento());
System.out.println("回退一个版本后的版本信息：");
System.out.println(git.getState());
}
}
现在这个备份者就类似于一个备份的仓库管理员，创建一个丢进去，需要的时候再拿出来。这就是备忘录模式。
3. 备忘录模式
3.1 定义
备忘录模式（Memento Pattern）提供了一种弥补真实世界缺陷的方法，让“后悔药”在程序的世界中真实可行，其定义如下：
Without violating encapsulation,capture and externalize an object's internalstate so that the object can be restored to this state later.（在不破坏封装性的前提下，捕获一个对象的内部状态，并在该对象之外保存这个状态。这样以后就可将该对象恢复到原先保存的状态。）
3.2 通用类图
- Originator 发起人角色：记录当前时刻的内部状态，负责定义哪些属于备份范围的状态，负责创建和恢复备忘录数据。
- Memento 备忘录角色：负责存储 Originator 发起人对象的内部状态，在需要的时候提供发起人需要的内部状态。
- Caretaker 备忘录管理员角色：对备忘录进行管理、保存和提供备忘录。
3.3 通用代码
发起人：
public class Originator {
private String state;
public String getState() {
return state;
}
public void setState(String state) {
this.state = state;
}
// 创建一个备忘录
public Memento createMemento() {
return new Memento(this.state);
}
// 恢复一个备忘录
public void restoreMemento(Memento memento) {
this.setState(memento.getState());
}
}
备忘录：
public class Memento {
private String state;
public Memento(String state) {
this.state = state;
}
public String getState() {
return state;
}
public void setState(String state) {
this.state = state;
}
}
备忘录管理员：
public class Caretaker {
// 备忘录对象
private Memento memento;
public Memento getMemento() {
return memento;
}
public void setMemento(Memento memento) {
this.memento = memento;
}
}
场景类：
public class Client {
public static void main(String[] args) {
// 定义发起人
Originator originator = new Originator();
// 定义备忘录管理员
Caretaker caretaker = new Caretaker();
// 创建一个备忘录
caretaker.setMemento(originator.createMemento());
// 恢复一个备忘录
originator.restoreMemento(caretaker.getMemento());
}
}
4. clone 方式的备忘录
我们可以通过复制的方式产生一个对象的内部状态，这是一个很好的办法，发起人角色只要实现 Cloneable 就成，比较简单：
public class Originator implements Cloneable {
// 内部状态
private String state;
public String getState() {
return state;
}
public void setState(String state) {
this.state = state;
}
private Originator backup;
// 创建一个备忘录
public void createMemento() {
this.backup = this.clone();
}
// 恢复一个备忘录
public void restoreMemento() {
this.setState(this.backup.getState());
}
// 克隆当前对象
@Override
protected Originator clone() {
try {
return (Originator) super.clone();
} catch (CloneNotSupportedException e) {
e.printStackTrace();
}
return null;
}
}
备忘录管理员：
public class Caretaker {
// 发起人对象
private Originator originator;
public Originator getOriginator() {
return originator;
}
public void setOriginator(Originator originator) {
this.originator = originator;
}
}
场景类：
public class Client {
public static void main(String[] args) {
// 定义发起人
Originator originator = new Originator();
// 创建初始状态
originator.setState("初始状态");
System.out.println("初始状态：" + originator.getState());
// 创建备份
originator.createMemento();
// 修改状态
originator.setState("修改后的状态");
System.out.println("修改后的状态：" + originator.getState());
// 恢复状态
originator.restoreMemento();
System.out.println("恢复后的状态：" + originator.getState());
}
}
运行结果是我们所希望的，程序精简了很多，而且高层模块的依赖也减少了，这正是我们期望的效果。
但是我们来考虑一下原型模式深拷贝和浅拷贝的问题，在复杂的场景下它会让我们的程序逻辑异常混乱，出现错误也很难跟踪。因此 Clone 方式的备忘录模式适用于较简单的场景。
5. 多备份的备忘录
我们每天使用的 Windows 是可以拥有多个备份时间点的，系统出现问题，我们可以自由选择需要恢复的还原点。
我们上面的备忘录模式尚且不具有这个功能，只能有一个备份，想要有多个备份也比较简单，我们在备份的时候做一个标记，简单一点可以使用一个字符串。
我们只要把通用代码中的 Caretaker 管理员稍做修改就可以了：
public class Caretaker {
// 容纳备忘录的容器
private Map<String, Memento> mementoMap = new HashMap<>();
public Memento getMemento(String keys) {
return mementoMap.get(keys);
}
public void setMemento(String key, Memento memento) {
this.mementoMap.put(key, memento);
}
}
对场景类做部分修改：
public class Client {
public static void main(String[] args) {
// 定义发起人
Originator originator = new Originator();
// 定义备忘录管理员
Caretaker caretaker = new Caretaker();
// 创建两个备忘录
caretaker.setMemento("001", originator.createMemento());
caretaker.setMemento("002", originator.createMemento());
// 恢复一个指定的备忘录
originator.restoreMemento(caretaker.getMemento("002"));
}
}
6. 更好的封装
在系统管理上，一个备份的数据是完全、绝对不能修改的，它保证数据的洁净，避免数据污染而使备份失去意义。
在我们的程序中也有着同样的问题，备份是不能被褚篡改的，那么也就是需要缩小备忘录的访问权限，保证只有发起人可读就可以了。
这个很简单，直接使用内置类就可以了：
public class Originator {
private String state;
public String getState() {
return state;
}
public void setState(String state) {
this.state = state;
}
// 创建一个备忘录
public IMemento createMemento() {
return new Memento(this.state);
}
// 恢复一个备忘录
public void restoreMemento(IMemento memento) {
this.setState(((Memento)memento).getState());
}
private class Memento implements IMemento {
private String state;
private Memento(String state) {
this.state = state;
}
public String getState() {
return state;
}
public void setState(String state) {
this.state = state;
}
}
}
这里使用了一个 IMemento 接口，这个接口实际上是一个空接口：
public interface IMemento {
}
这个空接口的作用是用作公共的访问权限。
下面看一下备忘录管理者的变化：
public class Caretaker {
// 备忘录对象
private IMemento memento;
public IMemento getMemento() {
return memento;
}
public void setMemento(IMemento memento) {
this.memento = memento;
}
}
上面这段示例全部通过接口访问，如果我们想访问它的属性貌似是无法访问到了。
但是安全是相对的，没有绝对的安全，我们可以使用 refelect 反射修改 Memento 的数据。
在这里我们使用了一个新的设计方法：双接口设计，我们的一个类可以实现多个接口，在系统设计时，如果考虑对象的安全问题，则可以提供两个接口，一个是业务的正常接口，实现必要的业务逻辑，叫做宽接口；另外一个接口是一个空接口，什么方法都没有，其目的是提供给子系统外的模块访问，比如容器对象，这个叫做窄接口，由于窄接口中没有提供任何操纵数据的方法，因此相对来说比较安全。
作者：极客挖掘机
定期发表作者的思考：技术、产品、运营、自我提升等。
本文版权归作者极客挖掘机和博客园共有，欢迎转载，但未经作者同意必须保留此段声明，且在文章页面明显位置给出原文连接，否则保留追究法律责任的权利。
如果您觉得作者的文章对您有帮助，就来作者个人小站逛逛吧：极客挖掘机
