转自http://www.vckbase.com/document/viewdoc/?id=1871
源代码下载
串行化数据
串行化C++对象
定制串行化
串行化数据
——例子程序:Memo
创建一个新的单文档 SDI 应用,视图类选择 CFormView,以便用户可以在窗口中输入。 在界面中创建三个编辑框,然后再添加三个相应的编辑框变量。这三个变量是视图类的成员变量,为了交互数据,文档类中也要创建三个对应的变量。然后,文档类和视图类都要对数据成员进行初始化操作,在文档类中这个工作通常都在 OnNewDocument() 函数中进行。因为下面任何一个操作发生时都触发文档类 OnNewDocument()函数执行:
- 当用户启动应用程序;
- 当用户在“File”菜单中选择“New”选项;
视图类的初始化通常由 OnInitialUpdate() 负责,下面的任何一个操作发生时,代码都会触发视图类 OnInitialUpdate()函数执行 :
- 当用户启动应用程序;
- 当用户在“File”菜单中选择“New”选项;
- 当用户从“File”菜单中选择 “Open”选项;
在视图类中获得文档类指针的方法是:CFooDoc* pDoc = GerDocument();
用此文档指针便可以操作文档类数据:m_ViewData = pDoc->m_DocData;
串行化的代码很简单,ar 是一个与用户选择的文件相对应的文档对象(CArchive 对象):
// CFooDoc 序列化
void CFooDoc::Serialize(CArchive& ar)
{
if (ar.IsStoring())
{
// 将数据写入文件
ar << m_DocData;
}
else
{
// 从文件中读取数据
ar >> m_DocData;
}
}
这样就将数据写入了文件,选择“File”菜单中的“Save”或者“Save as”即可完成数据的串行化。 如果没有保存数据,退出程序是会提示用户是否保存修改过的数据。具体细节请参考源代码。
串行化C++对象
——例子程序:PHN
创建一个新的单文档 SDI 应用,视图类选择 CFormView,以便可以有窗口中用户可以输入。
声明一个要串行化的 C++ 类。如 CPhone;
文档类的处理:
在文档类中声明一个 MFC CObList 类对象,这个类很有用,功能也很强,用它可以很轻松地维护 C++ 对象列表,例如 添加、删除列表元素等。在文档类的头文件中作如下声明:
CObList m_PhoneList;
上面的声明可以是 public 类型,这样其它类可以直接访问它。也可以是 private 类型,这样就必须声明一个公共的访问函数,比如:GetPhoneList(),这个函数能返回 m_PhoneList 的地址。
通常可以在文档类的 OnNewDocument()函数中进行数据初始化;
// Create a CPhone Object
CPhone* pPhone = new CPhone();
pPhone->m_Name = "";
pPhone->m_Phone = "";
// Add new object to the m_PhoneList list
m_PhoneList.AddHead(pPhone);
在此 CPhone 类的成员变量的初始化不是必须的,因为 CPhone 的构造函数已经完成了这个工作。AddHead()函数向 m_PhoneList 列表添加刚创建的 CPhone 对象。所以,无论什么时候创建新文档(如启动应用程序)都会向 m_PhoneList 列表中添加一个空的 CPhone 对象。注意类 CObList 的成员函数 AddHead() 是向列表的“头部”添加对象(列表的开始),所以参数是想要添加的对象的地址。
删除 m_PhoneList 列表中的内容
因为 m_PhoneList 是在内存中维护的,所以要随时维护,只要下面三个事件中的任何一个事件发生,都需要从内存中删除 m_PhoneList 列表中的对象:
- 用户退出应用程序;
- 用户开始一个新的文档,如从“File”菜单中选择“New”选项;
- 用户打开一个已存在的文档,如从“File”菜单中选择“Open”选项;
在文档类的头文件中声明删除操作的函数:
virtual void DeleteContents();
其实现如下:
// 删除列表中的所有项目并释放列表对象占用的内存
while ( ! m_PhoneList.IsEmpty() )
{
delete m_PhoneList.RemoveHead();
}
视图类处理:
声明视图类的数据成员:
POSITION m_position; // 在文档类列表中的当前位置
CObList* m_pList; // 指向文档类的列表
在 OnInitialUpdate()函数中初始化视图类的数据成员
POSITION m_position;
CObList* m_pList;
// 获取文档类指针
CFooDoc* pDoc = (CFooDoc*) GetDocument();
// 获得文档类 m_PhoneList 的地址
m_pList = &(pDoc->m_PhoneList);
// 获得列表头位置
m_position = m_pList->GetHeadPosition();
// 用文档类数据更新视图类数据成员
CPhone* pPhone = (CPhone*)m_pList->GetAt(m_position);
m_Name = pPhone->m_Name;
m_Phone = pPhone->m_Phone;
// 用新的数据成员变量值更新屏幕显示
UpdateData(FALSE);
// 控制输入焦点
((CDialog*) this)->GotoDlgCtrl(GetDlgItem(IDC_NAME));
更新文档数据
当用户修改了视图类的数据成员,即修改了窗体编辑框中的内容时,执行这些代码后也会修改文档类的数据成员。
void CFooView::OnEnChangeName()
{
// 用屏幕输入更新控件变量
UpdateData(TRUE);
// 获得文档指针
CFooDoc* pDoc =(CFooDoc*)GetDocument();
// 更新文档
CPhone* pPhone = (CPhone*)m_pList->GetAt(m_position);
pPhone->m_Name = m_Name;
// 置修改标志为 TRUE
pDoc->SetModifiedFlag();
}
在列表中移动记录,修改视图类中相应的函数。
// 声明一个临时的位置变量
POSITION temp_pos;
// 用当前的列表位置更新 temp_pos
temp_pos = m_position;
// 用前一个/或后一个位置更新 temp_pos
m_pList->GetPrev(temp_pos);
if ( temp_pos == NULL)
{
// no previous element
MessageBox(_T("Bottom of file encountered!"),_T("Phone for Windows"));
}else
{
// 用列表前一个记录内容更新视图成员数据
m_position = temp_pos;
CPhone* pPhone = (CPhone*)m_pList->GetAt(m_position);
m_Name = pPhone->m_Name;
m_Phone = pPhone->m_Phone;
UpdateData(FALSE);
}
// 控制输入焦点
((CDialog*) this)->GotoDlgCtrl(GetDlgItem(IDC_NAME));
添加和删除列表记录:
//添加记录
// 清空屏幕输入控制
m_Name = "";
m_Phone = "";
UpdateData(FALSE);
// 创建一个新的 CPhone 对象
CPhone* pPhone = new CPhone();
pPhone->m_Name = m_Name;
pPhone->m_Phone = m_Phone;
// 添加新的对象到列表尾部,并用新的位置更新 m_position
m_position = m_pList->AddTail(pPhone);
// 获得文档指针
CFooDoc* pDoc = (CFooDoc*) GetDocument();
// 置修改标志为 TRUE
pDoc->SetModifiedFlag();
// 控制输入焦点
((CDialog*) this)->GotoDlgCtrl(this->GetDlgItem(IDC_NAME));
//删除记录
// 删除前先保存旧的指针
CObject* pOld;
pOld = m_pList->GetAt(m_position);
// 从列表中删除元素
m_pList->RemoveAt(m_position);
// 从内存中删除对象
delete pOld;
// 如果列表已经清空则添加一个空记录
if ( m_pList->IsEmpty())
{
OnBnClickedAddButton();
}
// 获取文档指针
CPHNDoc* pDoc = (CPHNDoc*) GetDocument();
// 置修改标志为 TRUE
pDoc->SetModifiedFlag();
// 显示列表的第一条记录
OnInitialUpdate();
串行化处理
我们要串行化 CPhone 对象,把C++对象写入文件,所以需要在 CPhone 类的定义和实现文件中加入相应的串行化代码,首先要在 CPhone 头文件中加入一个 MFC 宏,这是串行化需要的宏,必须为它提供一个参数,也就是类的名字。
// 串行化宏定义
DECLARE_SERIAL(CPhone)
其次是声明串行化函数,这个原型是必须的,因为要串行化类 CPhone 对象列表,所以 CPhone 类必须有一个属于自己的 Serialize()函数:
// 串行化函数 Serialize()
virtual void Serialize(CArchive& ar);
在 CPhone 实现文件中也要加入对应的代码,这个宏也是串行化需要的另一个宏,它有三个参数,第一个是类名,第二个是基类名,第三个是应用程序的版本号,可以将版本号定义为任何值,当串行化数据到文件时,此版本号也要写入文件。
// 串行化宏实现
IMPLEMENT_SERIAL(CPhone,CObject,0);
串行化函数 Serialize() 实现
if (ar.IsStoring())
{
ar << m_Name << m_Phone;
}
else
{
ar >> m_Name >> m_Phone;
}
这里要注意的是为了使用 CObList 类的成员函数 Serialize(),有几个前提条件需要满足:
- 列表类对象必须是 MFC CObject 类的派生类对象,也就是说 CPhone 类必须是 CObject 的派生类;
- 在列表中的对象类必须具备一个不带参数的构造函数。如果需要,也可以有其它带参数的构造函数;
- 必须声明和实现列表类的串行化函数 Serialize(),即 CPhone::Serialize();
- 实现列表对象的串行化必须使用 DECLARE_SERIAL/IMPLEMENT_SERIAL 宏;
调用列表 Serialize()函数
这一步是串行化列表 m_PhoneList,也就是调用 m_PhoneList 的成员函数 Serialize()。在什么地方调用呢?记住,无论用户什么时候从“File”菜单中选择“Save”或者“Save as”或“Open”选项,都将执行文档类的 Serialize()函数,所以必须在文档类的 Serialize()函数中调用 m_PhoneList 的 Serialize()函数。
这样一来,无论用户什么时候从 File 菜单中选择 Save/Save as 时,都将把 m_PhoneList 保存在用户选择的文件中,同样地,无论用户什么时候从选择 Open 时,都将把文件中保存的列表信息加载到 m_PhoneList 中来。m_PhoneList 的串行化调用如下:
m_PhoneList.Serialize(ar);
只要在文档类的 Serialize() 函数中调用上面这条语句时,必须把 ar 作为参数传入,它将完成需要串行化 m_PhoneList 列表数据的所有工作。不必在if语句中再做其它处理。
定制串行化
——例子程序:ARCH
串行化处理有时并不需要用户选择文件,此时仍要从或向一个特定文件串行化数据,本部分将描述怎样创建并定制一个 CArchive 对象。创建一个新的单文档 SDI 应用, 工程名为 ARCH。视图类仍然选择 CFormView。视图中两个编辑框和两个按钮,编辑框用于输入数据,“Save to File”按钮用于将输入的数据串行化到文件,“Load from File”按钮用于从文件中抽取数据。为简单起见,文件使用的硬编码。
下面是 “Save to File”的操作代码:
// 用屏幕输入内容更新 m_Var1 和 m_Var2
UpdateData(TRUE);
// 创建文件 C:\ARC.ARC
CFile f;
f.Open("c:\\arc.arc",CFile::modeCreate|CFile::modeWrite);
// 创建一个 CArchive 对象,并将文件与对象关联
CArchive ar(&f,CArchive::store);
// 串行化 m_Var1 和 m_Var2 到文档
ar<<m_Var1<<m_Var2;
// 关闭文档
ar.Close();
// 关闭文件
f.Close();
下面是 “Load from File”的操作代码:
// 打开文件 C:\ARC.ARC
CFile f;
if ( f.Open("c:\\arc.arc",CFile::modeRead ) == FALSE )
return;
// 创建一个 CArchive 对象,并将文件与对象关联
CArchive ar(&f,CArchive::load);
// 从对象中抽取数据并赋值给成员变量
ar>>m_Var1>>m_Var2;
// 关闭文档
ar.Close();
// 关闭文件
f.Close();
// 更新屏幕显示
UpdateData(FALSE);
以上是三个 MFC 串行化数据的例子,Memo 程序的功能是串行化数据到文件,Phn 程序是串行化 C++ 对象列表到文件,而 ARCH 则是定制串行化。详细实现细节请下载源代码。