序列化初步（翻译）
原著：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。注意，文件保存总是用最新的版本。
int CFoo::serialize
(CArchive* pArchive)
{
...
// Serialize the object ...
ASSERT (pArchive != NULL);
TRY
{
if (pArchive->IsStoring()) {
...
// Write employee name, id and department code
(*pArchive) << m_strName;
(*pArchive) << m_nId;
(*pArchive) << m_nDept;
}
else {
...
// Read employee name and id
(*pArchive) >> m_strName;
(*pArchive) >> m_nId;
// Read department code (new in version 2)
if (nVersion >= 2) {
(*pArchive) >> m_nDept;
}
else {
m_nDept = -1; // unknown
}
}
}
CATCH_ALL (pException)
{
nStatus = bSignatureRead && bVersionRead ? ERROR : INVALID_DATAFILE;
}
END_CATCH_ALL
return (nStatus);
}
