Apache XMLBeans 是一套開源的 XML 與 Java 綁定工具,能依 XML 結構描述(XML Schema)產生對應的 Java 類別與介面。有了這些 bean,解析或產生符合結構描述的 XML 文件就變得非常直觀。
但綁定越緊密,代價也越清楚:結構描述一動,bean 就得重新產生。理想情況下這沒什麼問題,麻煩的是應用程式往往必須同時支援多個結構描述版本。當 XML 被當成資料交換標準,向前與向後相容就不再是選項,而是需求。
想像一個員工資料管理應用程式:它以 XML 檔保存員工資訊,再用 XMLBeans 處理。最早的結構描述如清單 1,目標命名空間是 com.ibm.sample.employee:1,由 XMLBeans 的結構描述編譯器編出 bean,應用程式再拿這組類別去讀入符合該 XSD 的 XML。
清單 1. 員工 XML 結構描述的第一版
<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="com.ibm.sample.employee:1"
elementFormDefault="qualified"
xmlns="https://www.w3.org/2001/XMLSchema"
xmlns:tns="com.ibm.sample.employee:1">
<element name="employee" type="tns:employeeType"/>
<complexType name="employeeType">
<sequence>
<element name="firstName" type="string"/>
<element name="lastName" type="string"/>
<element name="department" type="string"/>
<element name="phone" type="string"/>
<element name="eEmail" type="string"/>
</sequence>
</complexType>
</schema>
清單 2 是處理用的應用程式,清單 3 是呼叫它的用戶端:
清單 2. XMLBeans 應用程式
public class EmployeeApplication {
public void parseXML(String XMLFileName) {
EmployeeDocument employeeDoc =
EmployeeDocument.Factory.parse(new File(XMLFileName));
EmployeeType employee = employeeDoc.getEmployee();
System.out.println(employee.getFirstName());
// 這裡接著做更有用的事
}
}
清單 3. 用戶端
EmployeeApplication app = new EmployeeApplication(); app.parseXML(XMLFilePath);
現在假設結構描述升級了:新增幾個元素,命名空間也改成 com.ibm.sample.employee:2 以標示第二版(清單 4)。為舊結構描述產生的 Java bean,再也讀不了新文件。
清單 4. 員工 XML 結構描述的第二版
<?xml version="1.0" encoding="UTF-8"?>
<schema targetNamespace="com.ibm.sample.employee:2"
elementFormDefault="qualified"
xmlns="https://www.w3.org/2001/XMLSchema"
xmlns:tns="com.ibm.sample.employee:2">
<element name="employee" type="tns:employeeType"/>
<complexType name="employeeType">
<sequence>
<element name="firstName" type="string"/>
<element name="lastName" type="string"/>
<element name="dept" type="string"/>
<element name="eMail" type="string"/>
<element name="phone" type="string"/>
<element name="address" type="tns:addressType"/>
</sequence>
</complexType>
<complexType name="addressType">
<sequence>
<element name="streetName" type="string"/>
<element name="houseNumber" type="string"/>
<element name="city" type="string"/>
<element name="state" type="string"/>
<element name="zipCode" type="string"/>
</sequence>
</complexType>
</schema>
你希望用戶端一行程式都不用改,但資料來源已經換到新版結構描述,應用程式必須能處理任何命名空間送進來的員工 XML。問題是 XMLBeans 天生無法同時管理互相衝突的結構描述——這時該怎麼辦?
在 Java 裡,類別載入器(class loader)是一等公民,也有自己的命名空間。一個由載入器載入的類別,是由「載入器身分 + 類別名稱」共同唯一決定的。也就是說,若 MyClassLoader 的兩個不同實例各自載入了 Foo,JVM 會把它們視為兩個不同的類別,各載入一次。
圖 1. Java 類別載入

類別載入採委派模型,而且是父載入器優先(parent-first):每個載入器在動手之前,會先把搜尋與載入的工作交給自己的父載入器。當載入器形成階層結構時,最上層的 bootstrap 載入器會先試,不行才輪到系統類別載入器,以此類推。
結論很直接:要同時處理兩個結構描述版本,就建立兩個不同的類別載入器實例,讓各自去載入對應版本的 bean 與應用程式。
接著做一個代理,以共用的介面站在原本的應用程式或 bean 前面。代理為每個 XML 結構描述版本準備一個類別實例,其父載入器設為目前執行緒的 context class loader;然後依收到的 XML 所屬版本,挑對應的載入器去載入該版本的 bean,以及應用程式本身。
為什麼連應用程式也要重載?因為當 JVM 試著載入應用程式用到的所有類別時,它會在同一個命名空間裡找;找不到就會丟出 ClassNotFoundException。
圖 2. 代理動態載入 XMLBeans

至於版本判斷,代理可以讀 XML 的命名空間,也可以讓 XML 自己帶一個標示 XSD 版本的元素,再用一個輕量的 SAX 解析器把資訊取出來。
回到員工資料管理應用程式。清單 5 是代理程式碼:
清單 5. 代理
/* 這兩個類別載入器宣告為 static:整組實例只需要一份。
若改用實例變數,只會製造出更多載入器與更多重複載入的類別。 */
private static URLClassLoader ccl1 = null, ccl2 = null;
private URLClassLoader createURLClassLoader(URL url) {
ClassLoader parent = Thread.currentThread().getContextClassLoader();
return new URLClassLoader(
new URL[]{ applicationJarURL, url }, parent);
}
private URLClassLoader loadXMLBeans(int choice) {
try {
switch (choice) {
case 1:
if (ccl1 == null) {
ccl1 = createURLClassLoader(
new URL("file", null, jarPath + "employee1.jar"));
}
return ccl1;
default: // 預設載入最新版本
case 2:
if (ccl2 == null) {
ccl2 = createURLClassLoader(
new URL("file", null, jarPath + "employee2.jar"));
}
return ccl2;
}
} catch (Exception e) {
e.printStackTrace();
return null;
}
}
public void parseXML(String XMLFileName) {
try {
// 先判斷傳入的 XML 採用哪個結構描述版本
URLClassLoader ccl = loadXMLBeans(choice);
Class c = ccl.loadClass(
"com.ibm.sample.application.employee.EmployeeApplication");
Class s = String.class;
Object obj = c.newInstance();
Method m = c.getDeclaredMethod("parseXML", new Class[]{ s });
m.invoke(obj, new Object[]{ XMLFileName });
} catch (Exception e) {
e.printStackTrace();
}
}
清單 5 裡,命名空間 com.ibm.sample.employee:1 的 bean 被打成 employee1.jar,com.ibm.sample.employee:2 的則放進 employee2.jar。執行期這兩個 jar 都不會出現在 classpath 上——它們要由代理裡的 URLClassLoader 實例載入。若把它們掛在 classpath,父載入器(也就是系統類別載入器)就會搶先載入,多版本機制立刻失效,因為那些類別都落在系統載入器的命名空間裡。
整體流程是:代理判斷輸入 XML 採用哪個版本 → 建立(或取用)對應的 URLClassLoader 實例,把該 jar 的 URL 掛上去 → 用 Java 反射呼叫原應用程式的方法。之所以走反射,是因為應用程式是被非系統類別載入器載入的,編譯期看不到它。
用戶端的改動小到幾乎可以忽略(清單 6):
清單 6. 修改後的用戶端應用程式
// 改為建立代理實例,而不是直接建立員工應用程式 EmployeeApplicationProxy app = new EmployeeApplicationProxy(); app.parseXML(XMLFilePath);
這個範例裡,應用程式本身完全沒動。但也有一種情況:新結構描述(例如多了 address)需要新的處理邏輯,此時就必須維護兩套應用程式碼。這套做法同樣吃得下——你會載入不同版本的應用程式(或其中一部分)搭配該版本專屬的 bean。它的好處是改動幅度可以壓到最低,結構描述頻繁變動時也好管理,要新增或移除某個版本的支援都很容易。
即使 XMLBeans 本身不支援多個結構描述並存,你還是可以照樣用它處理 XML,同時把版本變異這件事管得好好的。下次遇到結構描述升版時,不妨試試這條路。