BinXML是我个人杜撰出来的名字，不知道是否合适，也不知道是否已存在类似的解决方案。在vcer.net上我将前一段时间的这个BinXML方案贡献出来，希望能够与广大vcer分享。

当时问题的背景是这样的，项目需要确定存储方案，这种方案需要满足如下要求：

• 生成的单机板exe尽可能的不依赖于其它软件，如：数据库管理系统；
• 存储的数据最好能够方便的拷贝，以满足项目的上报、汇总的功能；
• 存储的格式以后可能还会变，变化不频繁，但是最好能支持这种变化；
• 只需要数据的持久化与反持久化的功能，不需要查询统计等复杂功能；
• 存储的数据中可能包括一个或者多个的文件附件，如：word文档；
• 存储的数据可能被不同的平台使用，如：windows或者linux；
• 作为web项目的一部分，除了提供VC的接口之外，存储的数据格式需要提供java的接口；

我首先考虑到了MsAccess格式，文件型数据库，方便拷贝，而且表的设计很柔性化。在windows环境下，MsAccess似乎可以不需要再安装额外的驱动，但是在linux环境下，如何被java调用是个问题（当然，这个问题也是可以解决的，但是很别扭）。其次，使用RDB还有一个问题：数据的层次表达与多值问题，将树型数据扁平化存储的方案是有的，但是，将几层简单的节点拆分成N个表格，岂不是杀鸡用牛刀？

其次的考虑当然是XML，然而XML是基于可读文本的，如何解决二进制数据问题？当然可以通过编码的途径来解决，但是这样使用XML是不是太牵强了？而且，XML有个缺陷，数据都是文本型的。要使用数值型、布尔型、日期型的数据，需要做进一步的解析。

那么就使用自定义的数据文件格式？传统情况下，我们会用一个或者若干个struct将数据打包，一下子塞进文件。但是现在用户说了：我们现在定义的数据结构可能会变：） 看来，我们的存储方案还必须要足够的柔性化。

想到最后，我决定还是借鉴XML的树型标签形式，来实现一种二进制的存储结构，即BinXML：）

关于src包

对于BinXML-src里面的例子，数据的结构类似于：

<姓名>...</姓名> <年龄>...</年龄> <电话> <号码>...</号码> <号码>...</号码> </电话> <照片>...</照片> <备注>...</备注>

BinXML-src.zip包括两部分，一部分是vc的工程，一部分是java的工程，在Visual C++6.0和eclipse+JDK1.4中都已编译、运行通过。大家可以运行BinXML-bin.zip里面的exe程序，测试一下BinXML文件的加载和保存功能。

对象模型

BinXML的对象模型主要包括：文档（document）和节点（node）。每个文档包含一个根节点（root），根节点下面包含一个或者多个子节点，如此类推。

文档包含一个文件头，其中包含了一些标识串、操作系统版本、文件大小、文档创建时间等信息。

每个节点也包含一个节点头，表明该节点的名称以及大小。一般来说，用户不会直接接触到文件头和节点头这些信息。

如下为VC里的类声明：

//每个节点的头 struct TNodeHead { //节点类型 __int32 type; //名字的长度 __int32 size1; //值的长度 __int32 size2; TNodeHead() { memset(this, 0, sizeof(*this)); type = NODE_TYPE; size1 = -1; size2 = -1; } }; //文件格式异常 class CFileFormatException : public CException { private: CString m_Msg; public: CFileFormatException(CString msg); int ReportError(UINT nType = MB_OK, UINT nMessageID = 0); }; //BinXML文件头 struct TDocumentHead { char mark[8]; //标识串 __int32 version; //版本号 __int32 windows; //windows版本号 __int32 time; //创建时间 __int32 size; //文件大小 __int32 reserved; //保留字段 TDocumentHead() { memset(this, 0, sizeof(*this)); strcpy(mark, DOCUMENT_MARK); version = VERSION_NUMBER; windows = ::GetVersion(); size = -1; } }; //节点 class CMyNode { private: CPtrArray m_Children; //子节点 CString m_Name; //节点名称 CMyNode * m_Parent; //父节点 long m_Size; //值长度 byte * m_Value; //值 public: //获取指定名称的子节点列表 void GetChildren(CString name, CPtrArray & nodes); //获取指定名称的子节点的文本值 CString GetChildString(CString name); CMyNode(CMyNode * parent, CString name); //增加一个子节点 CMyNode * AppendChild(CMyNode * node); CMyNode * AppendChild(CString name, byte *value, long size); CMyNode * AppendChild(CString name, long value); CMyNode * AppendChild(CString name, CString value); //获取指定名称的子节点 CMyNode * GetChild(CString name); CMyNode * SetNumber(long value); CMyNode * SetString(CString value); //获取所有的子节点列表 CPtrArray & GetChildren(); //获取节点值的字节长度 long GetSize(); //获取节点字节 byte * GetBytes(); //获取节点数值 long GetNumber(); //获取节点文本 CString GetString(); ~CMyNode(); //获取节点名称 CString GetName(); //设置节点值 CMyNode * SetBytes(byte *value, long size); }; //文档 class CMyDocument { private: CMyNode m_Root; TDocumentHead m_Head; int LoadChildren(CFile &file, CMyNode *parent); int SaveChildren(CFile &file, CMyNode *parent); public: TDocumentHead * GetHead(); CMyNode * GetRoot(); void LoadFromFile(CFile & file); void SaveToFile(CFile & file); CMyDocument(); virtual ~CMyDocument(); };

在java里，定义了binxml.io包，其中的类、接口定义与以上相似。

你很容易想到，使用BinXML，可以很方便地完成CTreeCtrl的持久化。

如何使用？

如下是VC中加载BinXML的代码片断：

//加载BinXML CString path = fd.GetPathName(); CFile file; if(file.Open(path, CFile::modeRead)) { CMyDocument md; md.LoadFromFile(file); m_Name = md.GetRoot()->GetChild("姓名")->GetString(); m_Age = md.GetRoot()->GetChild("年龄")->GetNumber(); m_Memo = md.GetRoot()->GetChild("备注")->GetString(); //电话 m_Tel.ResetContent(); CMyNode * tel = md.GetRoot()->GetChild("电话"); if(tel) { CPtrArray pa; tel->GetChildren("号码", pa); for(int i = 0; i < pa.GetSize(); i++) { CMyNode * no = (CMyNode *)pa.GetAt(i); m_Tel.AddString(no->GetString()); } } //照片 CMyNode * pn = md.GetRoot()->GetChild("照片"); if(pn) { //读取二进制，存入文件吧 CFile photo; //创建一个临时文件 TCHAR temp[_MAX_PATH]; ::GetTempPath(_MAX_PATH, temp); ::GetTempFileName(temp, "bxm", 0, (LPSTR)(LPCTSTR)m_PhotoPath); photo.Open(m_PhotoPath, CFile::modeWrite); //写进去 photo.WriteHuge(pn->GetBytes(), pn->GetSize()); //搞定 photo.Close(); //显示:) LoadPhoto(m_PhotoPath); } UpdateData(FALSE); }

对应的，写入BinXML的代码片断：

//保存BinXML CString path = fd.GetPathName(); CFile file(path, CFile::modeCreate | CFile::modeWrite); //写入文件 CMyDocument md; //姓名，文本型 md.GetRoot()->AppendChild("姓名", m_Name); //年龄，数值型 md.GetRoot()->AppendChild("年龄", m_Age); //电话，多值型 CMyNode * tel = md.GetRoot()->AppendChild("电话", ""); for(int i = 0; i < m_Tel.GetCount(); i++) { CString s; m_Tel.GetText(i, s); tel->AppendChild("号码", s); } //照片，二进制 CFile photo; if(!m_PhotoPath.IsEmpty() && photo.Open(m_PhotoPath, CFile::modeRead)) { //加载文件内容 long size = photo.GetLength(); byte * bytes = new byte [size]; photo.ReadHuge(bytes, size); photo.Close(); md.GetRoot()->AppendChild("照片", bytes, size); delete [] bytes; } //备注，文本型 md.GetRoot()->AppendChild("备注", m_Memo); md.SaveToFile(file);

是不是很简单？在java里面，BinXML的一个测试用例：

public void testLoadFromFile() throws IOException, ClassNotFoundException, FileFormatException { //加载binxml File f = new File("C:\\Documents and Settings\\bluejoe\\桌面\\aaa.bxl"); TDocument d = new TDocument(f); //根结点 Node nd = d.getRoot(); assertEquals("白乔", nd.getChild("姓名").getString()); assertEquals("姓名", nd.getChild("姓名").getName()); assertEquals(30, nd.getChild("年龄").getLong()); assertEquals( "\r\n\r\n你有一个苹果，我有一个苹果，\r\n我们交换一下，一人还是一个苹果；\r\n你有一个思想，我有一个思想，\r\n我们交换一下，一人就有两个思想；", nd.getChild("备注").getString()); Node tel = nd.getChild("电话"); assertEquals(2, tel.getChildren().size()); assertEquals("号码", ((Node) tel.getChildren().get(0)).getName()); assertEquals("01088888888", ((Node) tel.getChildren().get(0)) .getString()); assertEquals("13688888888", ((Node) tel.getChildren().get(1)) .getString()); Node at = nd.getChild("照片"); byte[] bs = at.getBytes(); //读取原始照片 File f2 = new File("C:\\Documents and Settings\\bluejoe\\桌面\\mm.bmp"); assertEquals(f2.length(), bs.length); //比较二进制内容 FileInputStream fis = new FileInputStream(f2); byte[] bs2 = new byte[(int) f2.length()]; fis.read(bs2); for (int i = 0; i < bs2.length; i++) { assertEquals(bs[i], bs2[i]); } }

TODO

希望BinXML能给你带来一定的帮助和启发，更多的是希望能带来启发：）希望有兴趣的哥们继续完善BinXML，别忘了在你的大名之前保留我的版权信息：

//by bluejoe, 2007.12 //mail: bluejoe@vcer.net //see also

BinXML需要完善的地方表现在：

• 暂时只实现了string/long/byte[]，还没有提供其它类型的解析与转换；
• XML标签不支持属性，只支持子元素：）
• 是不是可以提供一个oxm模型，完成BinXML与Object之间的直接映射，现在这个映射工作还是人工代码实现的，譬如：GetString/GetLong，等等。应该可以完善一个映射机制，自动根据定义好的类型进行转换；