XML Catalog 能依 XSD 即時校驗 XML 檔案。開發者在 XML 編輯器中輸入內容時,不必另外撰寫程式,只要完成少量設定,就能立即看到結構錯誤或驗證提示。
不過,實務環境往往更複雜。開發環境中的手動設定未必能帶到運行環境,且許多 XML 檔案未必採用標準寫法。本文將說明如何透過擴展 XML Catalog 與 URI Resolver,實現更自動化、更通用的即時校驗。
XML Catalog 源自 OASIS XML Catalog 規範,用來描述 XML 檔案如何引用外部資源。Eclipse WTP 提供相關支援,能利用 Catalog 將 XML 與對應的 XSD 關聯起來,進而完成即時校驗。
一個 Catalog 檔案通常包含 DOCTYPE 宣告、catalog 根元素、group 群組,以及 public 或 system 對應項。DOCTYPE 用來宣告這是 OASIS Catalog 檔案;若環境沒有網路,可能需要移除或註解,避免處理器嘗試下載 DTD。
catalog 元素包含命名空間資訊。group 元素則可設定整組條目的共同屬性,例如 prefer 與 xml:base。prefer="public" 表示解析器會優先使用 PUBLIC 識別符;xml:base 則定義相對 URI 的基底路徑。
public 元素會把 publicId 對應到實際 uri。publicId 通常是資源的唯一識別,常見做法是使用命名空間。system 元素則把 systemId 對應到 uri,systemId 往往代表資源在檔案系統中的路徑。
XML Catalog 提供資源重新定位機制,可把 XML 中引用的 URI 或命名空間導向另一個位置。這在開發與生產環境中很有用,因為遠端資源可能無法穩定存取,相對路徑也可能因檔案結構不同而失效。
當 XML 引用外部 XSD 時,解析器會透過 Catalog 中的對應關係找到本機或指定位置的文件。校驗器再依該 XSD 驗證 XML。與一次性透過程式指定 XSD 不同,Catalog 可用命名空間批次處理多個 XML 檔案,只要它們共用同一個 XSD。
在 Eclipse 中,可透過 File、New、Other、Examples、Editing and Validating XML files 開啟相關設定。

Catalog 設定頁通常會區分使用者定義與外掛提供的條目。手動新增的設定會放在使用者指定條目中。

新增條目時,Location 指向 XSD 檔位置。這裡可選擇工作空間中的 student.xsd。

完成後,Eclipse 會自動補上 Key Type 與 Key。Key Type 表示以命名空間作為關聯依據,Key 則是 XML 命名空間的值。


設定完成後,用 XML 編輯器開啟 sample.xml。若內容符合 XSD,不會有錯誤提示。

若刪除必要元素,例如某個學生缺少 age,編輯器會顯示紅色標記與波浪線,滑鼠停留時還會說明 student 元素不完整。這就是 Catalog 帶來的即時校驗效果。

手動配置雖然簡單,但通常只在開發環境有效。若產品要交付給使用者,不能要求使用者自行設定 XSD。此時需要讓設定隨外掛或產品一起部署,並在運行時自動生效。
解決方式之一是擴展 XML Catalog Contributions 擴展點。這樣可以把 Catalog 條目寫入 plugin.xml,讓 Eclipse 在啟動時載入,而不依賴使用者介面手動新增。
開啟 plugin.xml 的 Extensions 頁簽,加入擴展點。

在擴展點篩選框輸入 org.eclipse.wst.xml.core.catalogContributions,選取後按確定。

新增成功後,Extension 頁簽會顯示對應的 catalogContributions 節點。

接著新增 catalogContribution,並在其中新增 public 條目。


public 條目有兩個關鍵屬性:publicId 與 uri。publicId 對應 XML 命名空間,uri 則指向 XSD 實體位置,可透過 Browse 選擇。

完成設定後,plugin.xml 會呈現對應的擴充內容。與手動設定不同,運行環境中的 User Specified Entries 可能看不到使用者條目,但 Catalog 仍可由外掛擴充提供。


若此時把 sample.xml 改錯,一樣可以看到 XML Catalog 的即時提示,代表擴充設定已在運行時生效。

雖然 XML Catalog 很強大,但仍有邊界。若 XML 沒有命名空間,Catalog 很難依命名空間建立對應;若 XML 使用 xsi:schemaLocation,但該位置是虛擬或無效路徑,Catalog 也可能找不到真正的 XSD。
以下範例中的 sample.xml 含有 xsi:schemaLocation,並把 XSD 指向一個不存在或無效的網路位置。此時可透過自訂 URI Resolver,把資源重新導向正確的 XSD。

URIResolver 負責定位資源。Catalog 處理器會依解析器回傳的位置找到 XSD,再進行校驗。Eclipse 提供 resolverExtensions 擴展點,讓開發者註冊自訂解析器。

該擴展點通常有三個屬性:class、stage 與 priority。class 指定實作 URIResolver 的類別;stage 決定解析器在正規化前、正規化後或實體定位階段執行;priority 則控制同階段解析器的優先順序。

完成擴充後,plugin.xml 會包含 resolverExtensions 設定。實作時,可讓 resolve 方法接收檔案、基底路徑、publicId 與 systemId,再透過 Catalog Manager 的 resolvePublic 等方法,把命名空間導向正確的 XSD 路徑。

XML Catalog 讓 XML 與 XSD 的關聯變得自動化,而 URI Resolver 則補足了特殊引用情境下的定位問題。兩者結合後,開發者能在 Eclipse 或客製化工具中建立即時、可擴充、可部署的 XML 校驗機制,大幅提升資料品質與開發效率。