用Digester實現xml轉換成bean

    項目中要用到解析配置文件的功能，google了一下，發現基本都是說用Digester的，正好工程中有這個jar包，所以可以用，研究了一下。Digester原來是struts1.x下面的jar，但由於解析xml到bean是個如此常用的功能，於是就分出來了，成爲apache一個單獨的項目了，它用純java實現。試了一下，解析xml還是挺方便的。下面是我改寫了官網提供的一個例子，基本覆蓋常用的功能。

 

example.xml:

 <address-book> <person id="1" category="acquaintance" birth="1978-10-16"> <name>Gonzo</name> <email type="business">[e-mail]</email> <address> <type>home</type> <street>123 Maine Ave.</street> <city>Las Vegas</city> <state>NV</state> <zip>01234</zip> <country>USA</country> </address> <address> <type>business</type> <street>234 Maple Dr.</street> <city>Los Angeles</city> <state>CA</state> <zip>98765</zip> <country>USA</country> </address> <hobbie> <item>sprots</item> <item>pets</item> </hobbie> </person> <person id="2" category="rolemodel" birth="1958-2-3"> <name>Kermit</name> <email type="business">[e-mail]</email> <email type="home">[e-mail]</email> <address> <type>business</type> <street>987 Brown Rd</street> <city>Las Cruces</city> <state>NM</state> <zip>75321</zip> <country>USA</country> </address> <hobbie> <item>driving</item> <item>music</item> </hobbie> </person> </address-book>

 

beans:

package addressbook; import java.util.LinkedList; public class AddressBook { LinkedList people = new LinkedList(); public void addPerson(Person p) { people.addLast(p); } }package addressbook; import java.util.ArrayList; import java.util.List; public class Hobbie { private List<String> items = new ArrayList<String>(); public void addItem(String item) { items.add(item); } public List<String> getItems() { return items; } }

 

 package addressbook; import java.util.ArrayList; import java.util.HashMap; import java.util.Iterator; import java.util.List; /** * See Main.java. */ public class Person { private int id; private String category; private String name; private HashMap<String, String> emails = new HashMap<String, String>(); private List<Address> addresses = new ArrayList<Address>(); private Hobbie hobbie; private String birthDay; /** * A unique id for this person. Note that the Digester automatically * converts the id to an integer. */ public void setId(int id) { this.id = id; } public void setCategory(String category) { this.category = category; } public void setName(String name) { this.name = name; } /** * we assume only one email of each type... */ public void addEmail(String type, String address) { emails.put(type, address); } public void addAddress(Address addr) { addresses.add(addr); } public void setHobbie(Hobbie hobbie) { this.hobbie = hobbie; } public HashMap<String, String> getEmails() { return emails; } public void setEmails(HashMap<String, String> emails) { this.emails = emails; } public List<Address> getAddresses() { return addresses; } public void setAddresses(List<Address> addresses) { this.addresses = addresses; } public Hobbie getHobbie() { return hobbie; } public void setBirthDay(String birthDay) { this.birthDay = birthDay; } }

 

 

 

package addressbook; import java.util.HashMap; import java.util.Iterator; public class Address { private String type; private String street; private String city; private String state; private String zip; private String country; public String getType() { return type; } public void setType(String type) { this.type = type; } public String getStreet() { return street; } public void setStreet(String street) { this.street = street; } public String getCity() { return city; } public void setCity(String city) { this.city = city; } public String getState() { return state; } public void setState(String state) { this.state = state; } public String getZip() { return zip; } public void setZip(String zip) { this.zip = zip; } public String getCountry() { return country; } public void setCountry(String country) { this.country = country; } }

 

 

 

測試類：

package addressbook; import org.apache.commons.digester.Digester; public class Main { public static void main(String[] args) throws Exception { Digester d = new Digester(); AddressBook book = new AddressBook(); d.push(book); addRules(d); d.parse(Main.class.getResource("/addressbook/example.xml")); System.out.println("bye bye"); } private static void addRules(Digester d) { d.addObjectCreate("address-book/person", Person.class); //建立Person對象 d.addSetProperties("address-book/person"); //在AddressBook上添加這個person d.addSetNext("address-book/person", "addPerson"); //讀取name d.addCallMethod("address-book/person/name", "setName", 0); // d.addBeanPropertySetter("address-book/person/name"); //添加email d.addCallMethod("address-book/person/email", "addEmail", 2); d.addCallParam("address-book/person/email", 0, "type"); d.addCallParam("address-book/person/email", 1); //添加address對象 d.addObjectCreate("address-book/person/address", Address.class); d.addSetNext("address-book/person/address", "addAddress"); d.addSetNestedProperties("address-book/person/address"); //添加Hobbie對象 d.addObjectCreate("address-book/person/hobbie", Hobbie.class); d.addSetNext("address-book/person/hobbie", "setHobbie"); d.addCallMethod("address-book/person/hobbie/item", "addItem", 0); } }

 

 

簡單說明一下，

1）當創建bean中的bean屬性時，如AddressBook的Person對象，總是需要兩步：

addObjectCreate

addSetNext

前者是告訴系統下面的元素會映射成一個對象，後者告訴系統用當前父對象的哪個方法將這個新的子對象添加進來,不能以addCallMethod代替,如果用了,會發現多個元素時,只有一個被添加了進去,原因我也不知道,文檔講得也不清楚.

 

2）讀取attribute

   兩種辦法，一種是addSetProperties（），它會用xml中的attribute來設置bean上同名的property，如果兩者名字不同怎麼辦，如例中xml裏是birth，而bean中叫birthDay，用第二種辦法addSetProperties("address-book/person","birth","birthDay");

 

3）將元素文本設置給bean的property

   我一般比較喜歡用addBeanPropertySetter，用addCallMethod也可以，不過要指定參數的個數，如果只有一個參數，那麼個數用0表示，a little weird。

 

   另外，addSetNestedProperties這個方法可以將一組元素按鈕元素名設置給bean的property，如：

<address> <type>business</type> <street>234 Maple Dr.</street> <city>Los Angeles</city> <state>CA</state> <zip>98765</zip> <country>USA</country> </address>

 

 用addSetNestedProperties("address-book/person/address")，它會把這些子元素都作爲property設置給address。

 

 如果想給bean設置一個常量的屬性，addCallMethod之後用addObjectParam即可。Digester一點兒也難，多動手練習就會明白。

 

 是不是很簡單？瞭解了原理，當xml結構變化時，可以簡單地修改下代碼就同步了，另外有種辦法貌似是用xmlbeans，用annotation實現的，在一個項目中見過，不過沒研究過。

 

官方例子：

http://svn.apache.org/viewvc/commons/proper/digester/trunk/src/examples/

 

需要的其它jar包，commons-logging，BeanUtils

如果想使用日誌，定義個commons-logging.properties文件，附上以下內容：

 org.apache.commons.logging.Log=org.apache.commons.logging.impl.SimpleLog
  org.apache.commons.logging.simplelog.log.org.apache.commons.digester.Digester=debug
  org.apache.commons.logging.simplelog.log.org.apache.commons.digester.Digester.sax=info