C# 設計模式深度解析：備忘錄模式的實戰應用

編輯：關於C語言

一、前言：為何需要備忘錄模式？

在軟體開發過程中，我們經常面臨這樣的需求：必須保存物件在某一時刻的狀態，以便日後能夠撤銷操作或恢復到歷史版本。典型場景包括文檔編輯器的「復原/重做」功能、資料庫交易的回滾機制、遊戲中的存檔讀檔系統等。若直接暴露物件內部狀態供外部存取，將嚴重違反封裝原則，導致系統耦合度過高且難以維護。此時，備忘錄模式便成為了最佳解決方案。

二、備忘錄模式核心架構

備忘錄模式在不破壞封裝性的前提下，捕獲並外部化物件的內部狀態，使其以後可以恢復到這些狀態。其核心包含三大角色：

Originator（發起人）：負責創建備忘錄，記錄當前需要保存的內部狀態，並能從備忘錄中恢復狀態。
Memento（備忘錄）：存儲 Originator 的內部狀態，防止 Originator 以外的物件存取備忘錄內容。
Caretaker（管理者）：負責保管備忘錄，但不對其內容進行操作或檢查。

備忘錄模式結構圖

三、實戰案例：文檔版本管理系統

以下以文檔版本管理為例，展示如何在 C# 中實現備忘錄模式。

1. 定義發起人角色

public class Document
{
    public string Content { get; set; }

    /// 
    /// 創建備忘錄，保存當前文檔內容
    /// 
    public DocumentVersion CreateMemento()
    {
        return new DocumentVersion(Content);
    }

    /// 
    /// 從備忘錄恢復文檔狀態
    /// 
    public void SetMemento(DocumentVersion documentVersion)
    {
        Content = documentVersion.Content;
    }
}

2. 定義備忘錄角色

public class DocumentVersion
{
    public string Content { get; private set; }

    public DocumentVersion(string content)
    {
        Content = content;
    }
}

3. 定義管理者角色

public class Caretaker
{
    private readonly Dictionary<int, DocumentVersion> _mementoList = new Dictionary<int, DocumentVersion>();

    /// 
    /// 獲取指定版本的文檔
    /// 
    public DocumentVersion GetDocumentVersion(int versionId)
    {
        return _mementoList[versionId];
    }

    /// 
    /// 新增文檔版本，自動生成遞增版本號
    /// 
    public void AddDocumentVersion(DocumentVersion documentVersion)
    {
        int maxVersionId = _mementoList.Keys.Count == 0 ? 0 : _mementoList.Keys.Max();
        _mementoList.Add(maxVersionId + 1, documentVersion);
    }
}