當專案導入 XML 後,真正的挑戰往往不是語法,而是設計。XML 不只是資料格式,也可能是應用程式之間的介面。若把 XML 當成介面來設計,就能降低後續維護成本,並讓不同版本之間更容易相容。
Java 平台提供多種 XML API,例如 JAXB、JAXP、JAXR、JAX-RPC、SAAJ;社群中也有 JDOM、Castor、StAX 等方案。選擇太多時,開發者常直覺挑選最熟悉的 DOM,但這未必適合所有應用。
DOM 容易上手,卻容易讓 XML 結構滲透到整個系統。若每個模組都直接操作 DOM 樹,後續只要 XML 結構變動,就可能要修改大量程式。
契約式設計的精神,是明確定義元件之間的權責。對 XML 而言,詞彙表就是應用程式之間的契約。透過 XML Schema、RELAX NG 或 Schematron,可以描述文件結構、型別與約束,讓產製端與消費端有共同依據。
應用程式需求會演進,XML 詞彙表也會改變。良好的版本控制能讓舊程式讀取新文件時不會崩潰,也能讓新程式在必要時以相容模式運作。實作上,可用 version 屬性表示目前版本,用 compatibleWith 表示可處理的最低版本。
若新版本加入未知元素,舊程式應能忽略或回報錯誤,而不是直接失敗;若新版本破壞相容性,舊程式則應能拒絕開啟,並提示版本不足。
直接把物件模型映射成 XML,短期看似快速,長期卻可能帶來維護負擔。物件模型常包含效能導向的冗餘資訊、動態計算欄位、工具相依結構,或為了速度犧牲可讀性的位掩碼與陣列。這些設計未必適合 XML。
較穩健的做法,是找出物件模型中穩定的關係,再設計獨立且穩定的 XML 詞彙表。也可以從功能視角出發,描述應用程式對外提供的服務,而不是實作細節。
在應用程式端,應避免讓 DOM 樹成為全域資料模型。較好的方式,是建立專用的序列化套件,把 XML 讀寫集中封裝,其他模組只依賴自己的物件模型。
若所有套件都依賴 DOM 樹,會造成型別轉換不一致、驗證規則分散、演算法複雜、變更難追蹤等問題。把 XML 隔離後,反而更容易測試與維護。
這種做法的好處包括:XML 程式碼可集中測試、資料可在載入時重新組織成適合演算法的結構、容易導入 MVC,也讓物件模型能獨立演進。代價是初期設計成本較高,但長期能減少來回修改。
一點點設計上的深謀遠慮,能換來極大的維護效益。把 XML 當成介面,明確定義契約、版本與邊界,是 XML 專案能否長久穩定的關鍵。