XStream入门介绍2
????????? XStream中的核心类就是XStream类,一般来说,熟悉这个类基本就够用了,如果你用的更多,估计是你设计有问题,否则不需要。
????????? XStream 对象相当Java对象和XML之间的转换器,转换过程是双向的。创建XSteam对象的方式很简单,只需要new XStream()即可。
Java 到xml,用toXML()方法。
Xml到Java,用fromXML()方法。
在没有任何设置默认情况下,java到xml的映 射,是java成员名对应xml的元素名,java类的全名对应xml根元素的名字。而实际中,往往是xml和java类都有了,要完成相互转换,必须进 行别名映射。
别名配置包含三种情况:
1、类别名,用alias(String name, Class type)。
2、 类成员别名,用aliasField(String alias, Class definedIn, String fieldName)
3、 类成员作为属性别名,用 aliasAttribute(Class definedIn, String attributeName, String alias),单独命名没有意义,还要通过useAttributeFor(Class definedIn, String fieldName) 应用到某个类上。
别名的配置是非常重要的,但是其中有些细节问题很重要,在例子中会专门做详细说明。
??????? 另外还有不太常用的方法:
addImplicitCollection(Class ownerType, String fieldName),去掉集合类型生成xml的父节点。
registerConverter(Converter converter) ,注册一个转换器。
如果你的xml很大,或者为了安全性,以流的方式传输,那么XStream也提供丰富的API,使用起来也非常简便。目前还用不到,暂不考虑。
?????? 如果这些基本的操作还不能满足你应用的需求,XStream提供丰富的扩展点。你可以实现自己的转换器。还可以利用XStream完成更负责的功能,比如输出其他非xml格式的数据,还可以输出html,还支持XML Dom类型数据,这些应用起来稍微复杂些。当然这些不是XStream应用的重点,也不用理会,真正需要的时候再查看API和源码研究研究。
?????? XStream 的优点很多,但是也有一些小bug,比如在定义别名中的下划线“_”转换为xml后会变成“__”这个符号,很变态。因此,尽量避免在别名中实用任何符 号,却是需要下划线的时候,可以考虑实用连接符“-”,这个没有问题。
????? ?另外,我们的Java Bean中,常常有一些常量,在转换过程,XStream也会将这些常量转换过去,形成常量的xml节点,这显然不是想要的结果,对于常量字段,就不做转 换了。
package test;import java.util.List;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;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;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;import java.util.ArrayList;import java.util.List;import com.thoughtworks.xstream.XStream;import com.thoughtworks.xstream.io.xml.DomDriver;public class TestXStream {public static void main(String args[]) {test();}public static void test() {System.out.println("----------XStream学 习:http://lavasoft.blog.51cto.com----------");// 目标对象Address address1 = new Address("郑州市经三路", "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);// 转换装配XStream xStream = new XStream(new DomDriver());/************** 设置类别名 ****************/xStream.alias("PERSON", test.Person.class);xStream.alias("PROFILE", test.Profile.class);xStream.alias("ADDRESS", test.Address.class);output(1, xStream, person);/************* 设置类成员的别名 ***************/// 设置Person类的name成员别名NamexStream.aliasField("Name", Person.class, "name");/* * [注意] 设置Person类的profile成员别名PROFILE,这个别名和Profile类的别名一致, * 这样可以保持XStream对象可以从profile成员生成的xml片段直接转换为Profile成员, * 如果成员profile的别名和Profile的别名不一致,则profile成员生成的xml片段不可 * 直接转换为Profile对象,需要重新创建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);/******* 设置类成员为xml一个元素上的属性 *******/xStream.useAttributeFor(Address.class, "zipcode");/************* 设置属性的别名 ***************/xStream.aliasAttribute(test.Address.class, "zipcode", "Zipcode");output(3, xStream, person);/************* 将xml转为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>郑州市经三路</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>";// 同样实用上面的XStream对象xStreamSystem.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学 习:http://lavasoft.blog.51cto.com---------->>>第[ 1]次输出<PERSON> <name>熔岩</name> <age>27</age> <profile> <job>软件工程师</job> <tel>13512129933</tel> <remark>备注说明</remark> </profile> <addlist> <ADDRESS> <add>郑州市经三路</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>郑州市经三路</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>郑州市经三路</Add> </ADDRESS> <ADDRESS Zipcode="710002"> <Add>西安市雁塔路</Add> </ADDRESS> </ADDLIST></PERSON>Person{name='熔岩', age='27', profile=Profile{job='软件工程师', tel='13512129933', remark='备注说明'}, addlist=[Address{add='郑州市经三路', zipcode='450001'}, Address{add='西安市雁塔路', zipcode='710002'}]}Profile{job='软件工程师', tel='13512129933', remark='备注说明'}Address{add='西安市雁塔路', zipcode='710002'}
??
// 递归算法:遍历配置文件,找出所有有效的xpathprivate 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,标识无效的元素节点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);}}}/** * 过滤器接口方法,转换不规范字符,剔除无效节点 * * @param xmlStr * 要过滤的xml * @return 符合转换器要求的xml */public static String filter(String xmlStr) {Document document = null;try {document = DocumentHelper.parseText(xmlStr.replaceAll("__", "_"));// 递归的调用:标记要剔除的xml元素recursiveFixElement(document.getRootElement());List<Node> nodeList = document.selectNodes("//@delete");for (Node node : nodeList) {node.getParent().detach(); // 剔除xml元素}} catch (DocumentException e) {System.out.println(e.getMessage());e.printStackTrace();}return document.asXML();}
?
参考:http://www.ibm.com/developerworks/cn/xml/x-xstream/?
转载:http://blog.myspace.cn/e/407329705.htm