建立 XML 文檔並不難,但卻相當枯燥,尤其當你必須反覆產出結構相似的文檔時更是如此。用程式處理這些重複工作固然可行,但自動生成 XML 究竟是難是易,取決於你採用哪種方法。
過於簡化的回答是:建立 XML 和建立純文字檔一樣簡單,畢竟 XML 本質上就是文字檔。但更實際的說法是:手寫標記語言可能令人頭疼,你得時時留意引號有沒有漏掉、標籤是否成對、大小寫是否一致——這一切負擔都得自己扛。
而且 XML 文檔本質上是分層的,這意味著你要逐層深入,進行基於堆疊的操作:打開標籤、編輯屬性、增加子層,同時得緊盯目前最內層的元素。依照 XML 語法,為了不違反不重疊規則,你必須先關掉最內層元素。
XML 文檔物件模型(XML DOM)允許你用組合成法建立 XML。你呼叫一組製造方法(CreateElement、CreateComment、CreateProcessingInstruction 等)產生節點物件實例,再把它們關聯成一棵樹狀結構。但這些方法都在記憶體中建立文檔,那要如何保存呢?
直到 W3C XML DOM 第二層為止,官方 API 尚未提供 I/O 支援。一對 Load 與 Save 方法將成為官方第三層所推薦做法的一部分。缺乏 I/O 支援未必代表無法應用,但要記住:你目前使用的任何 Save 方法,都是對 W3C DOM 的專有擴充。微軟的 MSXML 從第一版起就支援文檔的持久化。
XML DOM 的關鍵優勢,是提供一個抽象層,讓你不必直接面對嚴謹的 XML 種種限制:由你定義結構,框架負責把內容翻譯成 XML 的細節。它的不足在於記憶體開銷——文檔在存入媒體前完全保留在記憶體裡,處理大型文檔時,從效能角度看並非最佳選擇。
微軟的 .NET Framework 提供了更高產、更有效率也更優雅的自動撰寫方式,其基礎是 XML 寫入器組件,代表的是與流式剖析模型相對應的寫出方法。
XML 寫入器提供了一個把 XML 數據輸出到流或檔案的快速、只能向前的方法。更重要的是,它在設計上保證所生成的 XML 都遵循 W3C XML 1.0 與命名空間的推薦規則。
與 XML DOM 不同,寫入器緩衝的資訊少得多,它並不在記憶體中表示整份文檔,而只是一個簡單的寫出工具,內部彙集各元素產生的 XML 文本,且隨時能把資料送往實體流——本機檔案、遠端 URL 或流物件。
假設你要寫一個把目錄清單灌進 XML 的類別,做法是建立一個新的 XmlTextWriter 並開始添加元素,用 DirectoryInfo 類別及其 GetDirectories 方法取得目錄資訊。
XmlTextWriter 是在磁碟檔案中建立 XML 的利器。傳給建構器的空引數代表採用預設的 UTF-8 編碼;Formatting 屬性則設定每行的自動縮排。
WriteStartDocument 與 WriteEndDocument 為文檔的撰寫加上括號:前者插入 XML 版本與編碼資訊,後者關閉所有懸置元素並重置內部狀態。在這兩者之間,你可以用其他 WriteXXX 方法建立節點、屬性與註解。
元素節點透過連續呼叫 WriteStartElement 與 WriteEndElement 來包裝,前者對應開啟標籤,後者對應關閉標籤。目前開啟元素的屬性用 WriteAttributeString 設定,最後 WriteString 把純文字插入元素主體。
預設情況下,文檔只有在呼叫 WriteEndDocument 時才會被送往底層流。若要寫大型文檔,Flush 方法能在撰寫過程中隨時清空內部緩衝、更新底層流,藉此優化記憶體占用。
XML 寫入器雖然好用,卻不完美:它不拿內容與 DTD 或結構描述做驗證,也不主動糾正你忽略的錯誤,例如重複添加同一屬性時不會提示。
閱讀器與寫入器是 .NET Framework 中每項 XML I/O 操作的基礎。用 XML 閱讀器可以更划算地剖析文檔;用 XML 寫入器,你則能超越標記抵達面向節點的層次,結合節點與實體來建構理想的結構描述與資訊集。