Java 生態裡與 XML 相關的規範不少,名字還都長得像。這裡按功能把它們梳理一遍,順帶說說幾個沒走標準路線但同樣值得知道的框架。
JAXP(Java API for XML Parsing)定義了 Java 中使用 DOM、SAX、XSLT 的通用接口。好處很直接:代碼只依賴接口,想換實現時不必改業務邏輯。比如覺得當前 XSLT 處理器太慢,換一個只需要調整 JAXP 配置。
通用接口的代價是「最小公分母」效應——支持的能力有限。JAXP 1.0 覆蓋 XML 1.0、XML Namespaces 1.0、SAX 1.0 和 DOM Level 1;JAXP 1.1 增加了 SAX 2.0、DOM Level 2 和 XSLT 1.0。所以如果你想用 Xalan 特有的 XPath 接口,JAXP 幫不上忙,只能把代碼綁定到具體 API 上。
另外值得提一句 JDOM。它並沒有實現 JAXP,但因為易用性出眾而廣受歡迎,並成為 JCP 正式推薦的 API。它同樣用樹狀結構表示 XML,用法比 W3C 的 DOM 標準簡單得多。新版 JDOM 內部已經開始調用 JAXP,能用的地方優先用 JAXP,不行時再退回自帶的默認實現(解析器 Xerces、XSLT 處理器 Xalan)。
JAXB(Java API for XML Binding)定義了 Java 數據對象與 XML 結構之間的雙向映射:既能把 Java 對象序列化成 XML 文檔,也能從 XML 文檔反序列化出 Java 對象。
它的工作方式是:準備好 XML 的 DTD 和 binding schema(注意這不是 XML Schema,而是一份描述 Java 對象與 XML 結構映射關系的文檔),JAXB 據此生成與 XML 結構一致的 Java 源文件;編譯之後,就可以用 unmarshalling 從 XML 得到對應對象,用 marshalling 反向寫回。
缺點也很清楚:一旦 XML 結構變了,binding schema 要重寫,生成的 Java 類也要重新生成並編譯。對於結構頻繁演進的項目,這份維護成本必須提前算進去。
JAXM(Java API for XML Messaging)為 SOAP 通信提供訪問方法和傳輸機制,支持 SOAP 1.1 規範以及同步、異步兩種通信方式。
它定義了大量服務,由實現產品提供,讓開發者不必直面複雜的通信系統。體系中有兩個重要角色:Client 通常作為 J2EE Web 或 EJB 容器的一部分,提供訪問 JAXM 服務的能力;Provider 的實現方式更多樣,主要負責發送和接收 SOAP 消息。
JAX-RPC(Java API for XML-RPC)是通過 XML 進行遠程過程調用的 Java API,基於 SOAP 技術,並以 SOAP 作為底層協議。對開發者而言,可見的只有方法、參數和返回值,底層的 SOAP 通信被完全隱藏,不需要直接打交道。
JAXM 與 JAX-RPC 在 Web Services 場景中配合使用:前者管消息,後者管調用語義。
JDK 1.4 自帶 JAXP 的參考實現:Crimson 的 DOM/SAX 解析器,以及 Xalan 的 XSLT 處理器。若想替換,就得了解它的查找順序,共四步:
javax.xml.transform.TransformerFactory 這樣的屬性定位實現類,可以在命令行直接指定:java -Djavax.xml.transform.TransformerFactory=com.foo.ConcreteTransformer YourApp
用 Ant 的話也可以寫在 build file 裡。類似的還有 javax.xml.parsers.DocumentBuilderFactory 和 javax.xml.parsers.SAXParserFactory。
lib/jaxp.properties,格式就是普通的 name=value。想知道 JRE 在哪:String javaHomeDir = System.getProperty("java.home");
注意某些 IDE(例如 JBuilder)會改寫 java.home 的值,別被它誤導。
META-INF/services 下建一個名為 javax.xml.transform.TransformerFactory 的文件,內容只有一行實現類名。com.foo.ConcreteTransformer
把這四步順序記住,排查「為什麼我的配置沒生效」這類問題時會省下不少時間——大多數情況都是某一層的優先級被忽略了。