DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> XML學習教程 >> XML詳解
在 C++Builder 6 中用 TXMLDocument 讀寫 XML 檔案
編輯:XML詳解     

處理 XML 需要 XML Parser。解析器大致分兩類:SAX 走事件驅動、逐行流式處理,模型簡單;DOM 會把整份文件載入成樹狀結構,使用直覺但記憶體佔用較高。C++Builder 6 的 TXMLDocument 元件走的是 DOM 路線,所以本文聚焦於此。

TXMLDocument 的使用障礙在哪裡

TXMLDocument 底層呼叫的是微軟的 MSXML DOM,而 MSXML 是基於 COM 的。在 VB 這類工具中使用 COM 物件非常直接,但在 C++Builder 裡卻不那麼順手。

我認為問題不在技術,而在於思维定式:VCL 的類設計得實在太貼心了,多數方法見名知意,幾乎不用查說明文件。可是用 TXMLDocument 時,很多方法名稱無法直觀推測其作用,甚至藏著一些不顯眼的陷阱,於是不得不翻 Help。

需求設定

本文用一個實際例子說明:做一個定時提醒日程的小程式。假設其他功能都已完成,剩下的問題是如何保存日程資料。既然要用 XML,就以 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。理解下面的基礎操作後,處理更複雜的結構會很直接。

步驟一:載入 XML 檔

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——這個順序能避免資料與顯示不一致。

幾個實務上的坑

1. 別忘了存檔

以上操作都只改動記憶體中的 DOM 樹。要寫回檔案,需另外呼叫:

XMLDoc->SaveToFile(WideString(AppPath) + "Tip.XML");

2. 節點順序即為索引

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 語法,比依賴索引安全得多。

3. 編碼務必一致

XML 宣告的 encoding、檔案實際存檔編碼、以及程式寫入時的編碼必須三者一致。中文環境用 GB2312 或直接使用 UTF-8 都可以,混用就是亂碼的根源。

4. 大量資料該改用 SAX 或替代方案

DOM 會把整份文件載入記憶體,文件一大就會有明顯的效能與記憶體問題。這種情況該改用 C++Builder 6 內建的 TClientCursor 搭配 XML 提供者,或改用 SAX 式的 ISAXXMLReader 走事件流。

今天的做法

C++Builder 6 已於 2002 年停止支援,MSXML 也已被微軟的 MSXML 6.0 取代(COM 介面大致相容,但建議改用 6.0 版以取得安全性修補)。若是新專案,C++ 端處理 XML 的主流選擇是:

  • pugixml:單一原始碼檔、API 清爽、效能優異,DOM 風格與本文用法相近。
  • RapidXML:極致效能取向,解析速度快但 API 較原始。
  • tinyxml2:文件量小、易於嵌入,適合小型專案。
  • Xerces-C++:Apache 出品,功能最完整(含 XSD 驗證),但體積龐大。

另外,若資料主要來自 Web API,今天的強烈建議是改用 JSON:解析成本更低,C++ 端有 nlohmann/json、RapidJSON 等成熟選擇,且無需處理編碼與命名空間的複雜度。XML 仍值得保留的場合是需要 XSD 驗證、命名空間,或與既有企業系統(SOAP、既有 ERP 介面)對接。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved