JAXM 開發 Web 服務實戰：從 SOAP 消息模型到圖書查詢案例

JAXM 核心概念

• 兩大包：`javax.xml.soap` (SAAJ，構建/解析 SOAP) 與 `javax.xml.messaging` (消息發送/接收規范)。
• 消息結構：Envelope → Header(可選) + Body(必選) + Fault(可選)；帶附件時增加 AttachmentPart。
• 連接模式：點對點 `SOAPConnection`（簡單，無需容器）與提供者模式 `ProviderConnection`（支援單向消息、客戶端雙向角色）。

案例：圖書城查詢服務

架構：Swing 客戶端 ↔ JAXM Servlet (Tomcat) ↔ EJB (JBoss) → 數據庫。提供三服務：全量查詢、分類查詢、名稱精確查詢。數據採用自定義 DTD 封裝於 SOAP Body。

服務端開發要點

1. Servlet 繼承 `JAXMServlet` 並實現 `ReqRespListener`，核心邏輯在 `onMessage(SOAPMessage)`。
2. 解析請求參數：
   SOAPEnvelope env = message.getSOAPPart().getEnvelope();
String category = ((SOAPElement)it2.next()).getValue();
3. 委派業務處理給 `XMLBusinessDelegate` → 調用 EJB → `BeanToSOAPEngine` 構建響應 SOAP。

客戶端開發流程

1. 創建 `SOAPConnection`。
2. 構建請求消息：手動構造或從文件載入 (`StreamSource`)。
3. 發送：`con.call(message, endpointURL)`。
4. 響應處理：`SOAPToBeanEngine` 將 SOAP 轉為 `Collection` 供 GUI 使用。

架構優勢

分層解耦：GUI → Business Interface → JAXMDelegate → SOAP 處理引擎。消息轉換邏輯集中封裝，業務層無感知通信細節。