Eclipse 設定 Hibernate XML 自動提示：DTD 目錄配置完整教程

問題背景

編寫 Hibernate 映射檔（*.hbm.xml）與配置檔時，若無 DTD 定義，Eclipse 無法提供標籤自動完成與驗證，開發效率大幅降低。本文詳述將 Hibernate DTD 註冊至 Eclipse XML Catalog 的完整步驟。

操作步驟

1. 取得 DTD 檔案

• 解壓 hibernate.jar（或 hibernate-core-x.x.x.jar）
• 在 org/hibernate 目錄下找到兩個關鍵檔案：
  • hibernate-configuration-3.0.dtd（配置檔 DTD）
  • hibernate-mapping-3.0.dtd（映射檔 DTD）

2. 開啟 Eclipse XML Catalog 設定

選單路徑：Window → Preferences → Web and XML → XML Catalog

3. 新增目錄條目

點擊右側 Add XML Catalog Entry，依序填入：

4. 驗證生效

• 開啟任意 .hbm.xml 或 hibernate.cfg.xml
• 輸入 <hibernate-mapping 或 <hibernate-configuration 時，應出現屬性自動提示
• 標籤錯誤會即時標紅提示

原理解析

XML Catalog 將遠端 DTD URI 映射至本地檔案，避免每次編輯都下載 DTD，同時啟用 Eclipse 的 XML 編輯器驗證與內容輔助功能。Key 必須與 XML 檔案中 <!DOCTYPE ... SYSTEM "..."> 或 PUBLIC "... 宣告的 URI 完全一致。

常見問題

• 提示不生效：檢查 Key URL 是否與 DOCTYPE 宣告完全一致（區分大小寫）
• 多版本共存：不同 Hibernate 版本 DTD 不同，建議按專案配置或使用版本號區分 Key
• 專案級設定：專案右鍵 Properties → XML Catalog 可針對單一專案覆蓋全域設定