不必寫一堆複雜的程式碼,就能讓 JavaBean 自己掌控與 XML 之間的雙向轉換。本文示範如何透過 JOX 完成這件事。
為了靈活回應 Web 應用與 Web 服務不斷變化的需求,Java 與 XML 的輕量與可擴充性成了理想組合。SAX、DOM、XSL、XSLT、SOAP、BML 等技術各據一方,但開發者往往得先跨越一整排 API 才能處理最單純的資料交換。
這個模式其實早就有先例。在 Java 分散式應用中,我們用 RMI 而不直接面對底層 socket;EJB 讓開發者不必操心交易、復原、啟用等機制。同樣地,有了 JavaBean 與 XML 的映射元件,開發者也不必直接處理 XML 相關 API——JOX 正是扮演這個角色。
package com.wutka.jox.test;
import com.wutka.jox.*;
import java.util.*;
public class TestBean implements java.io.Serializable
{
protected int foo;
protected String bar;
protected java.util.Date baz;
protected Vector thingies;
protected TestSubbean subbean;
public TestBean()
{
bar = "";
baz = new Date();
thingies = new Vector();
}
public int getFoo() { return foo; }
public void setFoo(int aFoo) { foo = aFoo; }
public String getBar() { return bar; }
public void setBar(String aBar) { bar = aBar; }
public java.util.Date getBaz() { return baz; }
public void setBaz(java.util.Date aBaz) { baz = aBaz; }
public TestSubbean getSub() { return subbean; }
public void setSub(TestSubbean aSub) { subbean = aSub; }
public String[] getThingies()
{
String[] retThingies = new String[thingies.size()];
if (thingies.size() > 0) thingies.copyInto(retThingies);
return retThingies;
}
public void setThingies(String[] newThingies)
{
thingies = new Vector(newThingies.length);
for (int i = 0; i < newThingies.length; i++)
{
thingies.addElement(newThingies[i]);
}
}
public String getThingies(int i)
{
return (String) thingies.elementAt(i);
}
public void setThingies(int i, String thingy)
{
thingies.setElementAt(thingy, i);
}
public String toString()
{
StringBuffer ret = new StringBuffer(
"foo=" + foo + ";bar=" + bar + ";baz=" + baz.toString() +
";thingies=");
for (int i = 0; i < thingies.size(); i++)
{
if (i > 0) ret.append(",");
ret.append((String) thingies.elementAt(i));
}
ret.append(";sub=");
ret.append(subbean.toString());
return ret.toString();
}
}
<?XML version="1.0"?>
<MarkTest>
<thingies>https://www.5a520.cn 小說520網</thingies>
<thingies>https://www.bt285.cn BT下載</thingies>
<thingies>https://www.bt285.cn/caj/ caj下載</thingies>
<thingies>https://www.bt285.cn/baolimotuo/ 暴力摩托</thingies>
<thingies>https://www.bt285.cn/btjinglin bt精靈</thingies>
<foo>5</foo>
<baz>6/25/00 12:46 AM</baz>
<bar>This is the website value</bar>
<sub>
<age>1</age>
<name>wangdei</name>
</sub>
</MarkTest>
package com.wutka.jox.test;
import com.wutka.jox.*;
import java.io.*;
public class TestDeser
{
public static void main(String[] args)
{
try
{
FileInputStream in = new FileInputStream("bean.XML");
JOXBeanInputStream joxIn = new JOXBeanInputStream(in);
TestBean testBean = (TestBean) joxIn.readObject(TestBean.class);
System.out.println(testBean);
}
catch (Exception exc)
{
exc.printStackTrace();
}
}
}
package com.wutka.jox.test;
import com.wutka.jox.*;
import java.io.*;
public class TestSer
{
public static void main(String[] args)
{
try
{
TestBean b = new TestBean();
b.setFoo(5);
b.setBar("This is the bar value");
b.setThingies(new String[] {
"https://www.5a520.cn 小說520網",
"https://www.bt285.cn BT下載",
"https://www.bt285.cn/caj/ caj下載",
"https://www.bt285.cn/baolimotuo/ 暴力摩托",
"https://www.bt285.cn/btjinglin bt精靈" });
TestSubbean sub = new TestSubbean();
sub.setName("Mark");
sub.setAge(35);
b.setSub(sub);
FileOutputStream fileOut = new FileOutputStream("bean.XML");
JOXBeanOutputStream joxOut = new JOXBeanOutputStream(fileOut);
// 第一個參數就是 XML 的根元素名稱
joxOut.writeObject("MarkTest", b);
joxOut.close();
}
catch (Exception exc)
{
exc.printStackTrace();
}
}
}
整份實作的核心其實就是一對串流類別:JOXBeanOutputStream 負責序列化,writeObject(rootName, bean) 的第一個參數決定 XML 的根元素名稱;JOXBeanInputStream 負責反序列化,readObject(TestBean.class) 只要傳入目標型別,JOX 就會依 bean 的 property 結構把 XML 對應回去。
值得注意的是命名對應規則:XML 中的元素名稱會對應到 bean 的 property 名稱,重複出現的 thingies 元素會被收斂成陣列或集合,巢狀的 sub 元素則對應到巢狀的 bean 物件。這意味著只要 JavaBean 的 getter/setter 結構設計得宜,XML 的樣子幾乎是自動決定的——反過來說,這也是使用這類映射工具時最該留意的地方。