|
|
XStream對象相當(dāng)Java對象和XML之間的轉(zhuǎn)換器，轉(zhuǎn)換過程是雙向的。創(chuàng)建XSteam對象的方式很簡單，只需要new XStream()即可。
Java到xml，用toXML()方法。
Xml到Java，用fromXML()方法。
在沒有任何設(shè)置默認(rèn)情況下，Java到xml的映射，是Java成員名對應(yīng)xml的元素名，Java類的全名對應(yīng)xml根元素的名字。而實(shí)際中，往往是xml和Java類都有了，要完成相互轉(zhuǎn)換，必須進(jìn)行別名映射。
別名配置包含三種情況：
1、類別名，用alias(String name, Class type)。
2、類成員別名，用aliasField(String alias, Class definedIn, String fieldName)
3、類成員作為屬性別名，用 aliasAttribute(Class definedIn, String attributeName, String alias)，單獨(dú)命名沒有意義，還要通過useAttributeFor(Class definedIn, String fieldName) 應(yīng)用到某個(gè)類上。
別名的配置是非常重要的，但是其中有些細(xì)節(jié)問題很重要，在例子中會專門做詳細(xì)說明。
另外還有不太常用的方法：
addImplicitCollection(Class ownerType, String fieldName)，去掉集合類型生成xml的父節(jié)點(diǎn)。
registerConverter(Converter converter) ，注冊一個(gè)轉(zhuǎn)換器。
如果你的xml很大，或者為了安全性，以流的方式傳輸，那么XStream也提供豐富的API，
使用起來也非常簡便。目前還用不到，暫不考慮。
如果這些基本的操作還不能滿足你應(yīng)用的需求，XStream提供豐富的擴(kuò)展點(diǎn)。你可以實(shí)現(xiàn)自己的轉(zhuǎn)換器。還可以利用XStream完成更負(fù)責(zé)的功能，比如輸出其他非xml格式的數(shù)據(jù)，還可以輸出html，還支持XML Dom類型數(shù)據(jù)，這些應(yīng)用起來稍微復(fù)雜些。當(dāng)然這些不是XStream應(yīng)用的重點(diǎn)，也不用理會，真正需要的時(shí)候再查看API和源碼研究研究。
XStream的優(yōu)點(diǎn)很多，但是也有一些小bug，比如在定義別名中的下劃線“_”轉(zhuǎn)換為xml后會變成“__”這個(gè)符號，很變態(tài)。因此，盡量避免在別名中實(shí)用任何符號，卻是需要下劃線的時(shí)候，可以考慮實(shí)用連接符“-”，這個(gè)沒有問題。
另外，我們的Java Bean中，常常有一些常量，在轉(zhuǎn)換過程，XStream也會將這些常量轉(zhuǎn)換過去，形成常量的xml節(jié)點(diǎn)，這顯然不是想要的結(jié)果，對于常量字段，就不做轉(zhuǎn)換了。
下面給出一個(gè)非常典型的而且實(shí)用的例子，作為對總結(jié)的補(bǔ)充：
package test;
import Java.util.List;
/**
* Created by IntelliJ IDEA.<br>
* <b>User</b>: leizhimin<br>
* <b>Date</b>: 2008-5-22 21:10:13<br>
* <b>Note</b>: Please add comment here!
*/
public class Person {
private String name;
private String age;
private Profile profile;
private List<Address> addlist;
public Person(String name, String age, Profile profile, List<Address> addlist) {
this.name = name;
this.age = age;
this.profile = profile;
this.addlist = addlist;
}
public String toString() {
return "Person{" +
"name='" + name + '/'' +
", age='" + age + '/'' +
", profile=" + profile +
", addlist=" + addlist +
'}';
}
}
package test;
import Java.sql.Date;
/**
* Created by IntelliJ IDEA.<br>
* <b>User</b>: leizhimin<br>
* <b>Date</b>: 2008-5-22 21:10:32<br>
* <b>Note</b>: Please add comment here!
*/
public class Profile {
private String job;
private String tel;
private String remark;
public Profile(String job, String tel, String remark) {
this.job = job;
this.tel = tel;
this.remark = remark;
}
public String toString() {
return "Profile{" +
"job='" + job + '/'' +
", tel='" + tel + '/'' +
", remark='" + remark + '/'' +
'}';
}
}
package test;
/**
* Created by IntelliJ IDEA.<br>
* <b>User</b>: leizhimin<br>
* <b>Date</b>: 2008-5-22 21:10:22<br>
* <b>Note</b>: Please add comment here!
*/
public class Address {
private String add;
private String zipcode;
public Address(String add, String zipcode) {
this.add = add;
this.zipcode = zipcode;
}
public String toString() {
return "Address{" +
"add='" + add + '/'' +
", zipcode='" + zipcode + '/'' +
'}';
}
}
package test;
import com.thoughtworks.xstream.XStream;
import Java.util.List;
import Java.util.ArrayList;
/**
* Created by IntelliJ IDEA.<br>
* <b>User</b>: leizhimin<br>
* <b>Date</b>: 2008-5-22 21:10:47<br>
* <b>Note</b>: XStream學(xué)習(xí)[http://lavasoft.blog.51cto.com]
*/
public class TestXStream {
public static void main(String args[]) {
test();
}
public static void test() {
System.out.println("----------XStream學(xué)習(xí):http://lavasoft.blog.51cto.com----------");
//目標(biāo)對象
Address address1 = new Address("鄭州市經(jīng)三路", "450001");
Address address2 = new Address("西安市雁塔路", "710002");
List<Address> addList = new ArrayList<Address>();
addList.add(address1);
addList.add(address2);
Profile profile = new Profile("軟件工程師", "13512129933", "備注說明");
Person person = new Person("熔巖", "27", profile, addList);
//轉(zhuǎn)換裝配
XStream xStream = new XStream();
/************** 設(shè)置類別名 ****************/
xStream.alias("PERSON", test.Person.class);
xStream.alias("PROFILE", test.Profile.class);
xStream.alias("ADDRESS", test.Address.class);
output(1, xStream, person);
/************* 設(shè)置類成員的別名 ***************/
//設(shè)置Person類的name成員別名Name
xStream.aliasField("Name", Person.class, "name");
/*[注意] 設(shè)置Person類的profile成員別名PROFILE,這個(gè)別名和Profile類的別名一致,
* 這樣可以保持XStream對象可以從profile成員生成的xml片段直接轉(zhuǎn)換為Profile成員,
* 如果成員profile的別名和Profile的別名不一致,則profile成員生成的xml片段不可
* 直接轉(zhuǎn)換為Profile對象,需要重新創(chuàng)建XStream對象,這豈不給自己找麻煩? */
xStream.aliasField("PROFILE", test.Person.class, "profile");
xStream.aliasField("ADDLIST", test.Person.class, "addlist");
xStream.aliasField("Add", test.Address.class, "add");
xStream.aliasField("Job", test.Profile.class, "job");
output(2, xStream, person);
/******* 設(shè)置類成員為xml一個(gè)元素上的屬性 *******/
xStream.useAttributeFor(Address.class, "zipcode");
/************* 設(shè)置屬性的別名 ***************/
xStream.aliasAttribute(test.Address.class, "zipcode", "Zipcode");
output(3, xStream, person);
/************* 將xml轉(zhuǎn)為Java對象 ******×****/
String person_xml = "<PERSON>/n" +
" <Name>熔巖</Name>/n" +
" <age>27</age>/n" +
" <PROFILE>/n" +
" <Job>軟件工程師</Job>/n" +
" <tel>13512129933</tel>/n" +
" <remark>備注說明</remark>/n" +
" </PROFILE>/n" +
" <ADDLIST>/n" +
" <ADDRESS Zipcode=/"450001/">/n" +
" <Add>鄭州市經(jīng)三路</Add>/n" +
" </ADDRESS>/n" +
" <ADDRESS Zipcode=/"710002/">/n" +
" <Add>西安市雁塔路</Add>/n" +
" </ADDRESS>/n" +
" </ADDLIST>/n" +
"</PERSON>";
String profile_xml = " <PROFILE>/n" +
" <Job>軟件工程師</Job>/n" +
" <tel>13512129933</tel>/n" +
" <remark>備注說明</remark>/n" +
" </PROFILE>";
String address_xml = " <ADDRESS Zipcode=/"710002/">/n" +
" <Add>西安市雁塔路</Add>/n" +
" </ADDRESS>";
//同樣實(shí)用上面的XStream對象xStream
System.out.println(xStream.fromXML(person_xml).toString());
System.out.println(xStream.fromXML(profile_xml).toString());
System.out.println(xStream.fromXML(address_xml).toString());
}
public static void output(int i, XStream xStream, Object obj) {
String xml = xStream.toXML(obj);
System.out.println(">>>第[ " + i + "]次輸出/n");
System.out.println(xml + "/n");
}
}
----------XStream學(xué)習(xí):http://lavasoft.blog.51cto.com----------
>>>第[ 1]次輸出
<PERSON>
<name>熔巖</name>
<age>27</age>
<profile>
<job>軟件工程師</job>
<tel>13512129933</tel>
<remark>備注說明</remark>
</profile>
<addlist>
<ADDRESS>
<add>鄭州市經(jīng)三路</add>
<zipcode>450001</zipcode>
</ADDRESS>
<ADDRESS>
<add>西安市雁塔路</add>
<zipcode>710002</zipcode>
</ADDRESS>
</addlist>
</PERSON>
>>>第[ 2]次輸出
<PERSON>
<Name>熔巖</Name>
<age>27</age>
<PROFILE>
<Job>軟件工程師</Job>
<tel>13512129933</tel>
<remark>備注說明</remark>
</PROFILE>
<ADDLIST>
<ADDRESS>
<Add>鄭州市經(jīng)三路</Add>
<zipcode>450001</zipcode>
</ADDRESS>
<ADDRESS>
<Add>西安市雁塔路</Add>
<zipcode>710002</zipcode>
</ADDRESS>
</ADDLIST>
</PERSON>
>>>第[ 3]次輸出
<PERSON>
<Name>熔巖</Name>
<age>27</age>
<PROFILE>
<Job>軟件工程師</Job>
<tel>13512129933</tel>
<remark>備注說明</remark>
</PROFILE>
<ADDLIST>
<ADDRESS Zipcode="450001">
<Add>鄭州市經(jīng)三路</Add>
</ADDRESS>
<ADDRESS Zipcode="710002">
<Add>西安市雁塔路</Add>
</ADDRESS>
</ADDLIST>
</PERSON>
Person{name='熔巖', age='27', profile=Profile{job='軟件工程師', tel='13512129933', remark='備注說明'}, addlist=[Address{add='鄭州市經(jīng)三路', zipcode='450001'}, Address{add='西安市雁塔路', zipcode='710002'}]}
Profile{job='軟件工程師', tel='13512129933', remark='備注說明'}
Address{add='西安市雁塔路', zipcode='710002'}
Process finished with exit code 0
在實(shí)際中，類的屬性很多，嵌套層次也很復(fù)雜，如果僅僅使用XStream原生API來硬編碼設(shè)置別名等屬性，顯得太生硬也難以維護(hù)。完全可以考慮通過一個(gè)xml配置文件來定義所有用到的類的別名定義（包括其成員），然后，通過讀取配置構(gòu)建一個(gè)XStream的工廠，在用到時(shí)候直接去取，而不是讓實(shí)用者組裝。我目前的一個(gè)項(xiàng)目中，就是這么實(shí)現(xiàn)的，效果非常的好。
下面我給出針對上面提出的問題一個(gè)解決方案：
思想：考慮做一個(gè)過濾器，在xml轉(zhuǎn)Java之前，在Java轉(zhuǎn)xml之后，應(yīng)用這個(gè)過濾器。這個(gè)過濾器提供將xml中的“__”替換為“-”，并且將xml中的不需要的節(jié)點(diǎn)剔除。
在過濾之前，我實(shí)現(xiàn)了個(gè)轉(zhuǎn)換器裝配，這一步通過xml來配置，并在Java中獲取。
代碼就省略了，這一步很靈活，關(guān)鍵看你的應(yīng)用了。
為了能過濾xml，我們需要用Dom4j遞歸遍歷xml文檔。下面一些算法代碼：
//遞歸算法：遍歷配置文件，找出所有有效的xpath
private static void recursiveElement(Element element) {
List<Element> elements = element.elements();
validXPathList.add(element.getPath());
if (elements.size() == 0) {
//沒有子元素
} else {
//有子元素
for (Iterator<Element> it = elements.iterator(); it.hasNext();) {
//遞歸遍歷
recursiveElement(it.next());
}
}
}
//遞歸算法：遍歷xml，標(biāo)識無效的元素節(jié)點(diǎn)
private static void recursiveFixElement(Element element) {
List<Element> elements = element.elements();
if (!validXPathList.contains(element.getPath())) {
element.addAttribute("delete", "true");
}
if (elements.size() == 0) {
//沒有子元素
} else {
//有子元素
for (Iterator<Element> it = elements.iterator(); it.hasNext();) {
Element e = it.next();
if (!validXPathList.contains(e.getPath())) {
e.addAttribute("delete", "true");
}
//遞歸遍歷
recursiveFixElement(e);
}
}
}
/**
* 過濾器接口方法，轉(zhuǎn)換不規(guī)范字符，剔除無效節(jié)點(diǎn)
*
* @param xmlStr 要過濾的xml
* @return 符合轉(zhuǎn)換器要求的xml
*/
public static String filter(String xmlStr) {
Document document = null;
try {
document = DocumentHelper.parseText(xmlStr.replaceAll("__", "_"));
//遞歸的調(diào)用：標(biāo)記要剔除的xml元素
recursiveFixElement(document.getRootElement());
List<Node> nodeList = document.selectNodes("http://@delete");
for (Node node : nodeList) {
node.getParent().detach(); //剔除xml元素
}
} catch (DocumentException e) {
System.out.println(e.getMessage());
e.printStackTrace();
}
return document.asXML();
}
jsp技術(shù)：XStream使用方法總結(jié)附實(shí)例代碼，轉(zhuǎn)載需保留來源！
鄭重聲明：本文版權(quán)歸原作者所有，轉(zhuǎn)載文章僅為傳播更多信息之目的，如作者信息標(biāo)記有誤，請第一時(shí)間聯(lián)系我們修改或刪除，多謝。
