5 Memento

自动关联目录:5 Memento

备忘录在不破坏封装的前提下捕获对象的内部状态,在对象之外保存它,并支持之后恢复。

难点从来不是"存下来",而是存下来但不把内部字段暴露出去。

结构

角色职责
Originator创建备忘录、用备忘录恢复自身
Memento存储状态的快照,对外部不透明
Caretaker保管备忘录,但不能读、不能改其中的内容

原笔记里的写法:

class Memento {
private:
	// 不一定通过字符串进行存储
	std::string m_Content;
public:
	Memento(const std::string&& content) : m_Content(content) {}
	std::string GetMementoContent();
};

class Abstract {
private:
	// some property
	...
public:
	Memento CreateMemento() {
		// 序列化
		...
		return Memento(state);
	}
	void ApplyMemento(const Memento& memento) {
		state = memento->GetMementoContent();
		// 反序列化
		...
	}
};

class User {
	void Do() {
		Abstract abstract;
		Memento memento = abstract.CreateMemento();
		// do something
		...
		abstract.ApplyMemento(memento);
	}
};

封装怎么做到的

关键在于窄接口与宽接口:

谁看到什么
Caretaker只能拿到 Memento 的不透明句柄(类型存在,内容不可读)
Originator能读写全部字段(友元或嵌套类型)

C++ 里的实现手段:

class Originator {
public:
    class Memento {                        // 嵌套类
        friend class Originator;           // 只有 Originator 能看内容
        State state_;
    public:
        Memento() = default;               // 对外只暴露默认构造
    };
    Memento  Save() const { Memento m; m.state_ = state_; return m; }
    void     Restore(const Memento& m) { state_ = m.state_; }
};

与序列化方案的关系

这条笔记需要更新到现代实践:GoF 的备忘录解决的是**"没有通用序列化机制时怎么存状态"。现在主流语言/框架都有成熟的反射与序列化,多数情况下直接用序列化做快照更简单**。

方案适用
序列化(Json / Protobuf / 引擎自带)状态要跨进程、跨存档、跨版本
手写备忘录只需进程内短期回滚,或状态不便序列化(含句柄、指针)
差分备忘录只存与上一快照的差异,存档体积敏感时

工程结论:跨会话用序列化,进程内撤销用手写快照或 Command 的 Undo。

何时用

场景说明
撤销点 / 检查点关卡编辑器、配表工具
存档 / 读档游戏进度快照
状态回滚事务失败、网络预测校正
时间旅行调试记录状态序列用于复现

工程要点

要点说明
快照成本全量快照在对象巨大时不可接受,改增量或结构共享
深度问题深拷贝还是浅拷贝,引用成员怎么处理,必须明确
版本兼容存档必须带版本号,旧档要有迁移路径
不可变性备忘录一旦创建就不该变,否则"恢复"失去意义
敏感数据序列化到磁盘前考虑加密与防篡改

常见坑

坑说明
备忘录暴露内部细节封装被破坏,等于把字段 public 了
Caretaker 直接修改备忘录恢复出错误状态
快照无限增长撤销历史要有上限,或按时间/操作合并
忘了深拷贝状态里还有指针,恢复后仍是共享的
存档不带版本号一改结构旧档全废

与引擎的对应

引擎机制对应
USaveGame + Serialize存档快照
编辑器事务(FScopedTransaction)撤销点
网络预测与回滚保存/恢复角色状态做校正
Checkpoint / 关卡重开状态快照与恢复