Java Web 服務第 3 部分：Axis2 數據綁定框架對比 — ADB、XMLBeans、JiBX

背景：Web 服務與數據綁定

Web 服務交換 XML 訊息，但應用層面向業務對象。數據綁定框架負責 XML ↔ Java 對象雙向轉換。Apache Axis2 設計之初即支援多種綁定：ADB（Axis 專用）、XMLBeans（全模式支援）、JiBX（現有類優先）。本文通過同一「圖書館服務」範例對比三者用法、優缺點與避坑指南。

Axis2 鏈接代碼生成：WSDL2Java

核心工具 org.apache.axis2.wsdl.WSDL2Java 從 WSDL 生成客戶端 Stub 與服務端 Skeleton。關鍵參數：

• -d adb|xmlbeans|jibx|none：選擇綁定（默認 adb）。
• -uw：解包 wrapped doc/lit 風格，簡化介面（ADB、JiBX 支援）。
• -ss -sd：生成服務端代碼與部署描述符。
• -Ebindingfile：JiBX 需預先提供綁定定義文件。

服務範例：圖書館服務

操作：getBook(isbn)、getTypes()、addBook(type, isbn, authors[], title)、getBooksByType(type)。WSDL 採用 document/literal wrapped 風格（見原文清單 4）。

三大綁定深度對比

1. ADB (Axis Data Binding) — Axis 專屬、緊密整合

• 生成模式：每個訊息一個類（GetBook, GetBookResponse 等），可用 -u 拆分為獨立文件。
• 客戶端調用：構建請求對象鏈，調用 Stub 方法（清單 5）。
• 解包模式 (-uw)：直接映射參數/返回值，代碼極簡（清單 6）。但 Axis 1.2 仍有穩定性問題（異步調用拋 ClassCastException），需等待後續版本修復。
• 優勢：零依賴、自動附件處理、針對 Axis 優化、從 WSDL 生成完整模型。
• 劣勢：僅限 Axis 環境、模式支援尚未完整（如 maxOccurs="unbounded" 選擇器、attributeFormDefault 等）。

2. XMLBeans — 全模式保真、模型最複雜

• 文檔層包裹：每個訊息多一層 Document 類（GetBookDocument），調用鏈更長（清單 7）。
• 無解包支援：無法簡化為參數風格。
• 模式驗證缺失：默認不強制模式約束，易生成/接受無效 XML（如缺必填元素、xsi:nil="true" 違反 schema）。需顯式調用 validate()，但效能極差。
• 優勢：模式覆蓋最全、適合複雜 schema 場景。
• 劣勢：API 複雜、驗證開銷大、Axis 1.2 錯誤處理有 Bug。

3. JiBX — 現有類優先、綁定分離、解包最穩定

• 工作流：先寫 Java 類 → 定義綁定映射 (binding.xml) → 編譯時增強字節碼 → 運行時轉換。
• 客戶端代碼：直接使用業務對象（Book, Type），構造函數友好（清單 9）。
• 解包模式：無需創建空請求對象，getTypes() 直接返回陣列（清單 10）。自 Axis 1.1.1 起穩定可用。
• 優勢：支援現有類、綁定與類解耦、可維護多版本 XML 映射、提供獨立錯誤修復版本（不升級 Axis 即可修復 Bug）。
• 劣勢：從 Schema 生成代碼支援極弱（Xsd2JiBx 未整合進 WSDL2Java），需手寫綁定；字節碼增強步驟可能衝突構建流程。

總結選型指南

未來展望：JAXB 2.0 / JAX-WS 2.0

Axis 1.2 開始實驗支援 JAXB 2.0 + JAX-WS 註解，後續版本將完善。Jibx2Wsdl 也可能整合 JAXB 註解作為自定義入口。下一部分將對比三大綁定的**效能基準**。