處理 XML 需要 XML Parser。解析器大致分兩類:SAX 走事件驅動、逐行流式處理,模型簡單;DOM 會把整份文件載入成樹狀結構,使用直覺但記憶體佔用較高。C++Builder 6 的 TXMLDocument 元件走的是 DOM 路線,所以本文聚焦於此。
TXMLDocument 底層呼叫的是微軟的 MSXML DOM,而 MSXML 是基於 COM 的。在 VB 這類工具中使用 COM 物件非常直接,但在 C++Builder 裡卻不那麼順手。
我認為問題不在技術,而在於思维定式:VCL 的類設計得實在太貼心了,多數方法見名知意,幾乎不用查說明文件。可是用 TXMLDocument 時,很多方法名稱無法直觀推測其作用,甚至藏著一些不顯眼的陷阱,於是不得不翻 Help。
本文用一個實際例子說明:做一個定時提醒日程的小程式。假設其他功能都已完成,剩下的問題是如何保存日程資料。既然要用 XML,就以 XML 檔格式儲存。
日程程式必然需要新增與刪除功能,而這兩個操作基本上已涵蓋 XML 處理的全部核心。
<?xml version="1.0" encoding="GB2312"?>
<!-- 注意編碼設為 GB2312,否則中文會亂碼 -->
<VTip>
<Tip>
<Mode>0</Mode>
<Time>2003/4/25 08:01:46</Time>
<Content>洗衣服</Content>
</Tip>
<Tip>
<Mode>1</Mode>
<Time>2003/4/25 PM 17:30:00</Time>
<Content>陪女朋友吃飯</Content>
</Tip>
</VTip>
這個格式相當規矩,沒有用到屬性與 DOCTYPE。理解下面的基礎操作後,處理更複雜的結構會很直接。
XMLDoc->LoadFromFile(WideString(AppPath) + "Tip.XML"); // XMLDoc 是 TXMLDocument 元件的名稱 XMLDoc->Active = true; FillList(); // 把 XML 內容填入 ListView
Active 設為 true 會觸發解析並建立 DOM 樹,之後才能操作節點。
void __fastcall TfrmMain::FillList()
{
lstMain->Items->BeginUpdate();
lstMain->Items->Clear();
_di_IXMLNode node = XMLDoc->DocumentElement; // 取得根節點 <VTip>
_di_IXMLNodeList nodes = node->ChildNodes; // 取得子節點清單
for (int n = 0; n < nodes->Count; n++)
{
TListItem* li = lstMain->Items->Add();
// 往下再取一層:VTip/Tip/Mode
node = nodes->Nodes[n]->ChildNodes->Nodes[0];
int m = String(node->GetText()).ToInt(); // 取文字並轉為整數
li->Caption = "";
li->ImageIndex = m + 5; // 依模式切換圖示
// 依序取出 Time 與 Content
li->SubItems->Add(nodes->Nodes[n]->ChildNodes->Nodes[1]->GetText());
li->SubItems->Add(nodes->Nodes[n]->ChildNodes->Nodes[2]->GetText());
}
lstMain->Items->EndUpdate();
}
執行後會得到如下的清單畫面:

BeginUpdate() 與 EndUpdate() 包在中間是為了效能:填入大量項目時先關閉重繪,全部完成後再一次性更新畫面,避免閃爍。
bool __fastcall TfrmMain::AddTask(int m, TDateTime &date,
TDateTime &time, String con)
{
_di_IXMLNode node = XMLDoc->DocumentElement; // 根節點
node = node->AddChild(L"Tip"); // 新增 <Tip>
_di_IXMLNode subnode = node->AddChild(L"Mode"); // <Mode>
subnode->SetText(WideString(m));
subnode = node->AddChild(L"Time"); // <Time>
subnode->SetText(WideString(date.DateString() + " " + time.TimeString()));
subnode = node->AddChild(L"Content"); // <Content>
subnode->SetText(WideString(con));
return true;
}
對照上面的 XML 結構來讀,這段程式碼非常直白:AddChild 建立子節點,SetText 設定文字內容。
int ind = lstMain->Selected->Index; // 要刪除的項目索引
_di_IXMLNode node = XMLDoc->DocumentElement;
int re = node->ChildNodes->Delete(ind);
if (re != -1)
lstMain->Items->Delete(ind); // XML 刪成功才同步移除畫面項目
先改資料再改畫面,若 Delete 回傳 −1 代表失敗,就不動 UI——這個順序能避免資料與顯示不一致。
以上操作都只改動記憶體中的 DOM 樹。要寫回檔案,需另外呼叫:
XMLDoc->SaveToFile(WideString(AppPath) + "Tip.XML");
ChildNodes->Nodes[i] 的索引依文件中的實際順序而定。若 XML 結構可能變動(例如某些 Tip 少了某個子元素),硬寫 Nodes[1] 就會出錯。較穩健的做法是用具名節點查詢:
_di_IXMLNode timeNode = nodes->Nodes[n]->SelectSingleNode(L"Time");
if (timeNode != NULL)
li->SubItems->Add(timeNode->GetText());
SelectSingleNode 支援 XPath 語法,比依賴索引安全得多。
XML 宣告的 encoding、檔案實際存檔編碼、以及程式寫入時的編碼必須三者一致。中文環境用 GB2312 或直接使用 UTF-8 都可以,混用就是亂碼的根源。
DOM 會把整份文件載入記憶體,文件一大就會有明顯的效能與記憶體問題。這種情況該改用 C++Builder 6 內建的 TClientCursor 搭配 XML 提供者,或改用 SAX 式的 ISAXXMLReader 走事件流。
C++Builder 6 已於 2002 年停止支援,MSXML 也已被微軟的 MSXML 6.0 取代(COM 介面大致相容,但建議改用 6.0 版以取得安全性修補)。若是新專案,C++ 端處理 XML 的主流選擇是:
另外,若資料主要來自 Web API,今天的強烈建議是改用 JSON:解析成本更低,C++ 端有 nlohmann/json、RapidJSON 等成熟選擇,且無需處理編碼與命名空間的複雜度。XML 仍值得保留的場合是需要 XSD 驗證、命名空間,或與既有企業系統(SOAP、既有 ERP 介面)對接。