Java 生態裡與 XML 有關的 API 不少,名字也像到令人頭暈:JAXP、JAXB、JAXM、JAX-RPC。這裡逐一梳理它們各自的定位。
JAXP 定義了在 Java 中使用 DOM、SAX 與 XSLT 的通用介面。程式只依賴這些通用介面,日後想替換底層實現時不必改代碼——比如你嫌某個 XSLT 處理器太慢,換掉它只需要調整 JAXP 的相關配置(後文詳述查找機制)。
作為共同介面,JAXP 也有「最小公分母」的侷限:它能支持的東西有限。JAXP 1.0 支持 XML 1.0、XML Namespace 1.0、SAX 1.0 與 DOM Level 1;JAXP 1.1 則加入 SAX 2.0、DOM Level 2 與 XSLT 1.0。也就是說,若你想用 Xalan 的 XPath 相關介面,JAXP 並未提供,只能把代碼綁定到 Xalan 的專屬 API 上。
順帶一提 JDOM:它雖然沒有實現 JAXP,但因為使用簡單而廣受歡迎,並成為 JCP 正式推薦的 API。JDOM 同樣以樹狀結構表現 XML,用法比 W3C 的 DOM 標準簡單得多。新版本的 JDOM 內部已開始使用 JAXP 的 API——能調 JAXP 就調 JAXP,不行才退回自己的預設實現(解析器 Xerces、XSLT 處理器 Xalan)。
JAXB 定義了 Java 數據物件與 XML 結構之間的一種雙向映射關係。有了它,你可以很方便地把 Java 物件存成 XML 文檔,也能從 XML 文檔實例化出 Java 物件。
它的運作結構是這樣的:先準備 XML 的 DTD 與 binding schema(注意這不是 XML Schema,而是一份描述「Java 物件 ↔ XML 結構」映射關係的 XML 文檔),透過這兩個文件,JAXB 就能生成與 XML 結構一致的 Java 源檔;編譯之後,便可依具體 XML 文檔得到對應的 Java 類(unmarshalling),反向操作(marshalling)亦然。
缺點也很明顯:一旦 XML 結構改變,就得重寫 binding schema 並重新生成、編譯 Java 類。
Sun 的節奏向來不快。在 JAXB 出台之前,市面上已經有一些 XML data binding 框架,同樣做綁定但並未實現 JAXB:
JAXM 為 SOAP 通訊提供訪問方法與傳輸機制,支援 SOAP 1.1 規範以及同步與異步通訊。它定義了大量服務,由實現產品提供,讓開發者不必直面複雜的通訊系統。
JAXM 架構中有兩個關鍵組件:JAXM Client 與 Provider。Client 通常作為 J2EE Web 或 EJB 容器的一部分,提供程式訪問 JAXM 服務的能力;Provider 可以有多種實現方式,主要負責發送與接收 SOAP 訊息。如此一來,你就能直接用 JAXM 的 API 收發 SOAP 訊息。
JAX-RPC 是透過 XML 進行遠程過程調用的 Java API,基於 SOAP 技術、以 SOAP 作為底層協議。對開發者而言,只有方法、參數與回傳值是看得見的,底層的 SOAP 通訊全被隱藏起來,不需要直接打交道的細節。
JAXM 與 JAX-RPC 在 Web 服務領域扮演重要角色:前者處理訊息層,後者處理調用層。
JDK 1.4 自帶的是 JAXP 的參考實現:Crimson 的 DOM/SAX 解析器,以及 Xalan 的 XSLT 處理器。若想用其他實現替換,就得了解 JAXP 的查找步驟,順序如下:
算法會先透過系統屬性來定位實現類,例如 javax.xml.transform.TransformerFactory。你可以在命令列直接指定:
java -Djavax.xml.transform.TransformerFactory=com.foo.ConcreteTransformer YourApp
其中 ConcreteTransformer 是實現了 TransformerFactory 的子類。若使用 Ant,也可以在 build file 中指定。同類屬性還有 javax.xml.parsers.DocumentBuilderFactory 與 javax.xml.parsers.SAXParserFactory。
若系統屬性中沒有指定,JAXP 會到 JRE 目錄下查找 lib/jaxp.properties。它像一般的 properties 檔一樣由 name=value 組成,例如:
javax.xml.transform.TransformerFactory=com.foo.ConcreteTransformer
那麼 JAXP 就會使用對應的 TransformerFactory 實現。在程式裡可以用這行取得 JRE 所在目錄:
String javaHomeDir = System.getProperty("java.home");
注意:某些 IDE(如 JBuilder)會改寫 java.home 的值,除錯時別被誤導。
若 jaxp.properties 不存在或沒有對應的值,JAXP 會改用 JAR 的服務提供者機制來定位正確的子類。做法很簡單:在 jar 檔的 META-INF/services 目錄下新建一個名為 javax.xml.transform.TransformerFactory 的檔案,內容只有一行:
com.foo.ConcreteTransformer
如果前三步都沒找到任何具體實現,JAXP 就會使用預設的 Crimson 與 Xalan。
理解這四步的意義在於:換解析器不該靠改代碼,而是靠約定好的配置約定。這也是 JAXP 這層抽象真正的價值所在。