新手指南－序列化篇之二

iteye_19129

于 2010-07-18 15:29:00 发布

阅读量82

点赞数

序列化初步（翻译）

原著：http://www.codeproject.com/cpp/serialization_primer2.asp

在第一部分，我们学到了如何通过CArchive类的serialize()函数来序列化一个简单对象。象下面的程序这样：

int CFoo::serialize

(CArchive* pArchive)

{

int nStatus = SUCCESS;

// Serialize the object ...

ASSERT (pArchive != NULL);

TRY

{

if (pArchive->IsStoring()) {

// Write employee name and id

(*pArchive) << m_strName;

(*pArchive) << m_nId;

}

else {

// Read employee name and id

(*pArchive) >> m_strName;

(*pArchive) >> m_nId;

}

CATCH_ALL (pException)

{

nStatus = ERROR;

}

END_CATCH_ALL

return (nStatus);

}

这段代码有一个问题，如果我们错误的从数据文件中去读取并不存在的信息会怎么样？如果数据文件中在CString之后不是一个整数，那么serialize()函数将返回ERROR。这也不错，但是如果我们可以给错误定位，并返回一个更加详细的错误信息，比如INVALID_DATAFILE，那就更好了。我们可以通过对象签名来确认我们是在读取一个有效的数据文件。

对象签名

对象签名就是用一个字符串来识别一个对象。我们修改Cfoo类的定义来增加一个签名：

class CFoo

{

...

// Methods

public:

...

CString getSignature();

// Data members

...

protected:

static const CString Signature; // object signature

};

签名在Foo.cpp中申明：

// Static constants

const CString CFoo::Signature = "FooObject";

下一步，我们修改serialize()函数，在序列化对象的数据成员前先序列化这个签名。如果遇到无效的签名，或者签名丢失，那么可以认为我们在试图读取一个并不包含有Cfoo对象的数据存储。以下是读取有签名的对象的流程：

以下是流程实现代码：

int CFoo::serialize

(CArchive* pArchive)

{

int nStatus = SUCCESS;

bool bSignatureRead = false;

// Serialize the object ...

ASSERT (pArchive != NULL);

TRY

{

if (pArchive->IsStoring()) {

// Write signature

(*pArchive) << getSignature();

// Write employee name and id

(*pArchive) << m_strName;

(*pArchive) << m_nId;

}

else {

// Read signature - complain if invalid

CString strSignature;

(*pArchive) >> strSignature;

bSignatureRead = true;

if (strSignature.Compare (getSignature()) != 0) {

return (INVALID_DATAFILE);

}

// Read employee name and id

(*pArchive) >> m_strName;

(*pArchive) >> m_nId;

}

CATCH_ALL (pException)

{

nStatus = bSignatureRead ? ERROR : INVALID_DATAFILE;

}

END_CATCH_ALL

return (nStatus);

}

你必须确保你所有的对象都有唯一的签名。具体的签名内容并不重要。如果你正在开发一批产品，那么在公司范围内增加一个对象签名注册步骤是非常有帮助的。另一方面，开发者将不会给不同的对象使用相同的签名。如果你想让你的数据文件更难以被反解，那么你应该使用一个与对象名称没有明显任何关系的签名。

版本

如果你在产品的生命周期内进行升级，那么你也许要通过增加或者删除数据成员来修改Cfoo类结构。如果你只是为Cfoo发布新的版本，并且试图从数据存储中读取旧版本的对象，那么将会失败。这明显是不可以接受的。Cfoo的任何版本都应该可以让一个更旧版本恢复。

换句话说，Cfoo的序列化方法应该是向前兼容的。这个问题通过给对象增加版本是很容易完成的。与给对象增加签名相同，我们增加一个整数常量来指定这个对象的版本号。

class CFoo

{

...

// Methods

public:

...

CString getSignature();

int getVersion();

// Data members

...

protected:

static const CString Signature; // object signature

static const int Version; // object version

};

对象的版本号在Foo.cpp中申明

// Static constants

const CString CFoo::Signature = "FooObject";

const int CFoo::Version = 1;

下一步，我们修改serialize()函数，在序列化签名之后，序列化对象的数据成员之前序列化版本。如果遇到更新的版本，我们试图读取一个对象不支持的版本，那么，在下面的例子中，我们就返回一个状态标志UNSUPPORTED_VERSION。

int CFoo::serialize

(CArchive* pArchive)

{

int nStatus = SUCCESS;

bool bSignatureRead = false;

bool bVersionRead = false;

// Serialize the object ...

ASSERT (pArchive != NULL);

TRY

{

if (pArchive->IsStoring()) {

// Write signature and version

(*pArchive) << getSignature();

(*pArchive) << getVersion();

// Write employee name and id

(*pArchive) << m_strName;

(*pArchive) << m_nId;

}

else {

// Read signature - complain if invalid

CString strSignature;

(*pArchive) >> strSignature;

bSignatureRead = true;

if (strSignature.Compare (getSignature()) != 0) {

return (INVALID_DATAFILE);

}

// Read version - complain if unsupported

int nVersion;

(*pArchive) >> nVersion;

bVersionRead = true;

if (nVersion > getVersion()) {

return (UNSUPPORTED_VERSION);

}

// Read employee name and id

(*pArchive) >> m_strName;

(*pArchive) >> m_nId;

}

CATCH_ALL (pException)

{

nStatus = bSignatureRead && bVersionRead ? ERROR : INVALID_DATAFILE;

}

END_CATCH_ALL

return (nStatus);

}

Cfoo的版本1包含两个数据成员：一个CString类型(m_strName)和一个int类型(m_nId)。如果我们在版本2中增加第三个成员(例如： int m_nDept)。那么我们必须决定，当读取一个旧版本时，m_nDept应该初始化为多少。在下面的例子中，我们初始化m_nDept为1，意味着这个职员的部门为“未知”。

class CFoo

{

...

// Data members

public:

CString m_strName; // employee name

int m_nId; // employee id

int m_nDept; // department code (-1 = unknown)

};

我们需要将Foo.cpp中对象的版本号改为2。

const int CFoo::Version = 2;

最后，我们修改serialize()函数中读取对象的部分，如果我们读取的是一个旧版本的数据文件，将m_nDept初始化为-1。注意，文件保存总是用最新的版本。