怎樣給串行化類分配版本號（可配置版本模式）

編寫可串行化類時，MFC用你指定的模式號制定一個粗略的版本控制方式。在向檔案寫數據時， MFC用模式標記該類的實例；而在讀回數據時，MFC將檔案中的記錄的模式號和應用程序中使用著的該類對象的模式號做比較，如果兩模式號不匹配，則MFC發送一個CArchiveException，其m_cause 等於CArchiveException::badSchema。沒有得到處理的該類異常會促使MFC顯示一個對話框，提示 “非預期的文件格式”。如果每次修改對象的串行化存儲格式時都能做到增加模式號，那麼就不怕這種無心的操作—試圖把磁盤中存的老版本對象讀入內存裡的新版本對象了。

有一個問題經常會突然在使用可串行化類的應用程序中出現，這就是向下兼容。換句話說，就是如何並行化在老版本應用程序中創建的對象。如果對象的持久存儲格式隨應用程序版本的更新發生了變化，這時你可能希望新版本應用程序對兩種格式都能讀。但是一旦MFC發現不配套的模式號，它就發送異常。鑒於MFC的結構特點，最好按照MFC的方式處理異常並終止串行化過程。可視化模式也就產生了。

可視化模式只是包含VERSIONABLE_SCHEMA標志的模式號。標志告訴MFC 應用程序針對某一類能夠處理多種串行化的數據格式。這種模式禁止CArchiveException，並允許應用程序對不同的模式號有判斷地響應。使用了可視化模式的應用程序可以提供用戶希望的向下兼容性。如果要編寫一個具有MFC可視化模式支持的可串行類，一般需要兩步：

將IMPLEMENT_SERLAL宏中的模式號與值VERSIONABLE_SCHEMA相或。

如果從檔案加載對象時需要調用CArchive::GetObjectSchema，則要修改類的Serialize函數，並相應地調整其並行化例程。GetObjectSchema返回要進行並行化對象的模式號。

調用GetObjectSchema時要注意幾個規則。首先，只有對象在被並行化時才能調用。其次，必須在讀取檔案對象數據之前調用。再者，它只能調用一次。如果GetObjectSchema在調用Serialize前後調用兩次，則返回－1。我們先看個例子，這是版本1的CLine類：

class CLine : public CObject
{
DECLARE_SERIAL (CLine)
protected:
　　CPoint m_ptFrom;
　　CPoint m_ptTo;
public:
　　CLine () {} // Required!
　　CLine (CPoint from, CPoint to) { m_ptFrom = from; m_ptTo = to; }
　　void Serialize (CArchive& ar);
};這是Serialize函數：void CLine::Serialize (CArchive& ar)
{
　　CObject::Serialize (ar);
　　if (ar.IsStoring ())
　　　　ar << m_ptFrom << m_ptTo;
　　else // Loading, not storing
　　　　ar >> m_ptFrom >> m_ptTo;
}在實現類的過程中出現的語句：IMPLEMENT_SERIAL (CLine, CObject, 1)

這個類就可以串行化了。目前版本號為1，如果後來又給CLine添加了一個持久性數據成員，則要把版本號增加到2，這樣主結構就能根據程序的不同版本區別串行化到磁盤的CLine對象了。否則，磁盤上的版本為1的CLine就可能被讀入內存中版本為2的CLine，從而可能造成嚴重後果。

假定在應用程序的第2版本中，你要修改CLine類，想添加一個成員變量，用來保存線的顏色。下面是修改後的類的聲明：class CLine : public CObject
{
DECLARE_SERIAL (CLine)
protected:
　　CPoint m_ptFrom;
　　CPoint m_ptTo;
　　COLORREF m_clrLine; // Line color (new in version 2)
public:
　　CLine () {}
　　CLine (CPoint from, CPoint to, COLORREF color)
　　　　{ m_ptFrom = from; m_ptTo = to; m_clrLine = color }
　　void Serialize (CArchive& ar);
};

因為線的顏色是持久屬性（也就是說，保存到檔案中的紅線在讀出時依舊是紅的。），所以你向修改 CLine::Serialize，使它在串行化m_ptFrom和m_ptTo之外還能串行化m_clrLine。這意味著要把CLine 的模式號增加到2。使用原類時按以下方式調用MFC的IMPLEMENT_SERIAL宏：IMPLEMENT_SERIAL(CLine,CObject,1)但是在修改後的類中，應該這樣調用IMPLEMENT_SERIAL：IMPLEMENT_SERIAL(CLine,CObject,2|VERSIONABLE_SCHEMA)

更新後的程序在讀取CLine對象時，如果對象的模式號是1，MFC也不會發送CArchive異常，因為模式號中有VERSIONABLE_SCHEMA標志。但是它會了解到：由於模式號從1變為2，兩個模式實際上是不同的。

現在工作只做到一半。最後一步是修改CLine::Serialize，使它根據GetObjectSchema不同的返回值並行化CLine。原Serialize函數如下：void CLine::Serialize (CArchive& ar)
{
　　CObject::Serialize (ar);
　　if (ar.IsStoring ())
　　　　ar << m_ptFrom << m_ptTo;
　　else // Loading, not storing
　　　　ar >> m_ptFrom >> m_ptTo;
}新函數如下：void CLine::Serialize (CArchive& ar)
{
　　CObject::Serialize (ar);
　　if (ar.IsStoring ())
　　　　ar << m_ptFrom << m_ptTo << m_clrLine;
　　else {
　　　　UINT nSchema = ar.GetObjectSchema ();
　　　　switch (nSchema) {
　　　　case 1: // Version 1 CLine
　　　　　　ar >> m_ptFrom >> m_ptTo;
　　　　　　m_clrLine = RGB (0, 0, 0); // Default color
　　　　　　break;
　　　　case 2: // Version 2 CLine
　　　　　　ar >> m_ptFrom >> m_ptTo >> m_clrLine;
　　　　　　break;
　　　　default: // Unknown version
　　　　　　AfxThrowArchiveException (CArchiveException::badSchema);
　　　　　　break;
　　　　}
　　}
}

明白它是怎樣工作的嗎？CLine對象寫到檔案上時，它的格式總是CLine的第2個版本。但是讀取 CLine時，根據GetObjectSchema返回值的不同，它又被當做CLine版本1或版本2讀回。如果模式號為1，則對象按老方式讀取，並把m_clrLine設置為默認值。如果模式號為2，則對象所以數據成員，包括 m_clrLine,都要從檔案中讀取出來。其他模式號會導致CArchiveException，表示不能識別版本號（如果發生異常，可能是因為程序錯了或檔案壞了。）如果將來還要修改CLine，則要把模式號增加到3並給新模式添加一個case程序段。

明白了串行化類分配版本號，我們現在看個例子吧： 這是我不久前編的一個程序，只是為了學習MFC而編的，沒有什麼實際意義，而且網絡上有很多這樣的程序。編的不好，不要見笑，哈哈^_^自己先笑了。在squareDoc.h文件中：class CSquareDoc : public CDocument
{
protected: // create from serialization only
　　CSquareDoc();
　　DECLARE_SERIAL(CSquareDoc)//注意這句
// Attributes
public:
// Operations
public:
........//省略的部分程序代碼，具體看例子
}在squareDoc.cpp文件中：#include "stdafx.h"
#include "square.h"
#include "squareDoc.h"
#ifdef _DEBUG
#define new DEBUG_NEW
#undef THIS_FILE
static char THIS_FILE[] = __FILE__;
#endif
........//省略部分程序代碼，具體看例子
/////////////////////////////////////////////////////////////////////////////
// CSquareDoc
IMPLEMENT_SERIAL(CSquareDoc, CDocument,2|VERSIONABLE_SCHEMA)//注意這句
BEGIN_MESSAGE_MAP(CSquareDoc, CDocument)
　　//{{AFX_MSG_MAP(CSquareDoc)
　　//}}AFX_MSG_MAP
END_MESSAGE_MAP()
........//省略部分程序代碼，具體看例子
void CSquareDoc::Serialize(CArchive& ar)
{
　　ar.SerializeClass(RUNTIME_CLASS(CSquareDoc));
　　CDocument::Serialize(ar);
　　if (ar.IsStoring())　　//保存數據
　　{
　　　　SaveData(ar);　　//只按最新版本存儲
　　}
　　else　　　　　　//提取數據
　　{
　　　　UINT nSchema=ar.GetObjectSchema();
　　　　switch(nSchema)
　　　　{
　　　　　　case 1:　　LoadDataV1(ar);break;//版本1
　　　　　　case 2:　　LoadDataV2(ar);break;//版本2
　　　　　　default:AfxThrowArchiveException(CArchiveException::badSchema);
　　　　　　　　break;
　　　　}
　　}
}

//保存數據

void CSquareDoc::SaveData(CArchive &ar)
{
　　//保存變量
　　ar<<iSpeed<<fenshu<<iBomb<<iMissile<<iA_bomb;
　　//保存地圖數據
　　for(int i=0;i<SQUARE_AMOUNT_y;i++)
　　{
　　　　for(int j=0;j<SQUARE_AMOUNT_x;j++)
　　　　{
　　　　　　ar<<mc[j][i].CellPos.x<<mc[j][i].CellPos.y
　　　　　　　<<mc[j][i].IsFillFlag<<mc[j][i].rgb
　　　　　　　<<mc[j][i].size.cx<<mc[j][i].size.cy;
　　　　}
　　}
　　//保存方塊數據
　　ar<<sq.rgb<<sq.type;
　　for(i=0;i<4;i++)
　　{
　　　　ar<<sq.ps[i].x<<sq.ps[i].y;
　　}
　　//保存預知方塊數據
　　ar<<PreSq.rgb<<PreSq.type;
　　for(i=0;i<4;i++)
　　{
　　　　ar<<PreSq.ps[i].x<<PreSq.ps[i].y;
　　}
}
//提取版本1的數據
void CSquareDoc::LoadDataV1(CArchive &ar)
{
　　//提取變量
　　ar>>iSpeed>>fenshu;
　　//版本1中沒有炸彈、導彈和原子彈
　　iBomb=0;iMissile=0;iA_bomb=0;
　　//提取地圖數據(版本1中是單色)
　　for(int i=0;i<SQUARE_AMOUNT_y;i++)
　　{
　　　　for(int j=0;j<SQUARE_AMOUNT_x;j++)
　　　　{
　　　　　　ar>>mc[j][i].CellPos.x>>mc[j][i].CellPos.y
　　　　　　　>>mc[j][i].IsFillFlag>>mc[j][i].size.cx
　　　　　　　>>mc[j][i].size.cy;
　　　　　　mc[j][i].rgb=RGB(0,255,0);
　　　　}
　　}
　　//提取方塊數據(版本1中是單色)
　　ar>>sq.type;
　　sq.rgb=RGB(0,255,0);
　　for(i=0;i<4;i++)
　　{
　　　　ar>>sq.ps[i].x>>sq.ps[i].y;
　　}
　　//提取預知方塊數據(版本1中是單色)
　　ar>>PreSq.type;
　　PreSq.rgb=RGB(0,255,0);
　　for(i=0;i<4;i++)
　　{
　　　　ar>>PreSq.ps[i].x>>PreSq.ps[i].y;
　　}
}
//版本2
void CSquareDoc::LoadDataV2(CArchive &ar)
{
　　//提取變量
　　ar>>iSpeed>>fenshu>>iBomb>>iMissile>>iA_bomb;
　　//提取地圖數據
　　for(int i=0;i<SQUARE_AMOUNT_y;i++)
　　{
　　　　for(int j=0;j<SQUARE_AMOUNT_x;j++)
　　　　{
　　　　　　ar>>mc[j][i].CellPos.x>>mc[j][i].CellPos.y
　　　　　　　>>mc[j][i].IsFillFlag>>mc[j][i].rgb
　　　　　　　>>mc[j][i].size.cx>>mc[j][i].size.cy;
　　　　}
　　}
　　//提取方塊數據
　　ar>>sq.rgb>>sq.type;
　　for(i=0;i<4;i++)
　　{
　　　　ar>>sq.ps[i].x>>sq.ps[i].y;
　　}
　　//提取預知方塊數據
　　ar>>PreSq.rgb>>PreSq.type;
　　for(i=0;i<4;i++)
　　{
　　　　ar>>PreSq.ps[i].x>>PreSq.ps[i].y;
　　}
}
........//省略部分程序代碼，具體看例子。

結束語

你現在應該知道怎麼配置版本模式了吧，是不是很簡單阿！本程序在WinXP和VC++6.0下編譯通過。其實這個例子中還有很多地方值的參考，你可要仔細看看，在這裡我就不多說了，有什麼問題歡迎提出，大家可以討論討論。再次聲明，本程序只是為了學習MFC的朋友使用，可以隨意復制，修改，我想這種程序不會有人作為商業目的吧。有不同意見和問題的朋友，歡迎提出，謝謝！！！

本文配套源碼