一、简单介绍

XStream是thoughtworks开发的开源框架,用于实现XML数据于Java对象、Json数据的转换。它不需要schema或其他的mapping文件就可以进行java对象和xml文件之间的转换,API调用起来非常方便,并且扩展功能强大。

1XStream的特点

a)灵活易用:在更高的层次上提供了简单、灵活、易用的统一接口,用户无需了解项目的底层细节

b)无需映射:大多数对象都可以在无需映射的情况下进行序列化与反序列化的操作

c)高速稳定:设计时力求达到的最重要的指标是解析速度快、占用内存少,以使之能够适用于大的对象处理或是对信息吞吐量要求高的系统

d)清晰易懂:项目采用reflection机制得到无冗余信息的XML文件。所生成的XML文件较本地Java序列化产物更简洁,格式更清晰,更便于用户阅读

e)无需修改:完全序列化包括private和final类型在内的全部内部字段。支持非公有类和内部类,类可以没有缺省的构造函数。

f)易于集成:通过实现特定的接口,XStream可以直接与其它任何树型结构进行序列化与反序列化操作(而不仅仅是XML格式)

g)灵活转换:转换策略是可以定制的,允许用户自定义特殊类型的对象如何以XML格式存储。

h)错误处理:由于XML文本不合法而造成异常时,会提供详细地诊断信息帮助处理问题。

2,应用场合

a)数据对象的持久化

b)数据交换

c)配置文件

3,架构分析

a)Converters(转换器)

当XStream遇到需要转换的对象时,它会委派给合适的转换器实现,XStream为通用类型提供了多种转换器实现,包括基本数据类型、String、Collections、Arrays、null、Date,等等。

XStream提供了缺省的转换器,当需要转换的数据对象没有匹配的转换器时会使用。是通过反射机制自动完成对对象内所有字段的映射。

b)IO(输入/输出)

XStream是通过接口HierarchicalStramWriter和HierarchialStreamReader从底层XML数据中抽象而来的,上面的接口分别用于序列化和反序列化操作。

该特性使得XStream可以直接使用XML解析类从数据流中读取数据,或者是直接从已经存在的结构中提取数据(比如DOM)。如果XStream所操作的 XML数据已经部分被其它XML解析类处理过了(比如SOAP类的实例),这样就可以避免在我们这一层的再次解析操作。

c)Context(上下文引用)

在XStream序列化或反序列化对象时,它会创建两个类MarshallingContext和UnmarshallingContext,由它们来处理数据,以及委派合适的转换器。

XStream提供了三对上下文的缺省实现,它们之间有着细微的差别。缺省值可以通过方法XStream.setMode()来改变,需要传递下面参数中的一个:

i)XStream.XPATH_REFERENCES,(缺省的)通过XPath引用来标识重复的引用。这样产生的XML具有最小的混乱性。

ii)XStream.ID_REFERENCES,使用ID引用来标识重复的引用。在一些场合,比如使用手写XML时,这样将会更易于操作

iii)XStream.NO_REFERENCES,这种情况将失去对图形对象的支持,仅把对象看作为树型结构。重复的引用被视作两个不同的对象,循环引用会导致异常产生。相对于上面两种模式,这种模式速度会更快,占用内存会更

d)Facade(统一入口)

主要类XStream用作所有项目的入口点。它将上面所提及的重要组件集成在一起,提供更简单易用的API操作。

二、资源网址

项目主页:

http://xstream.codehaus.org/

在线帮助文档:http://xstream.codehaus.org/javadoc/index.html

lib和源码下载:http://xstream.codehaus.org/download.html

三、注意事项:

1,XStream将Java对象序列化为XML数据时,不关心属性字段是否是final、private类型,也不关心是否有对应的get/set方法,更不关心你是否有一个默认的无参构造方法。

2,项目的classpath中应该有3个包:xstream-[版本].jar,xpp3-[版本].jar,xmlpull-[版本].jar。

四、使用入门示例及介绍

1,示例代码

  1. import com.thoughtworks.xstream.XStream;
  2. import com.thoughtworks.xstream.io.xml.DomDriver;
  3. import com.thoughtworks.xstream.io.xml.StaxDriver;
  4. public class XStreamTest {
  5. public static void main(String[] args) {
  6. Person p = new Person();
  7. p.sex = new StringBuffer("未知");
  8. p.set("如花");
  9. p.age = 70;
  10. System.out.println("转换之前的Person对象p="+p);
  11. //这样创建XStream实例时,上面那3个jar包必须都有
  12. //    XStream xstream = new XStream();
  13. //这里不需要XPP3库了,而是使用标准的JAXP DOM解析XML
  14. //    XStream xstream = new XStream(new DomDriver());
  15. //这里不需要XPP3库了但是需要你使用java 6
  16. XStream xstream = new XStream(new StaxDriver());
  17. String xml = xstream.toXML(p);
  18. System.out.println("转换生成XML字符串=="+xml);
  19. Person p2 = (Person) xstream.fromXML(xml);
  20. System.out.println("转换之后的Person对象p2="+p2);
  21. }
  22. }
  23. class Person{
  24. private String name;
  25. int age;
  26. public StringBuffer sex;
  27. public void set(String name){
  28. this.name = name;
  29. }
  30. public String toString(){
  31. return "{name="+name+";age="+age+";sex="+sex+"}";
  32. }
  33. }

运行结果:

转换之前的Person对象p={name=如花;age=70;sex=未知}

转换生成XML字符串==<?xml version="1.0" ?><cn.tjpu.zhw.xml.Person><name>如花</name><age>70</age><sex>未知</sex></cn.tjpu.zhw.xml.Person>

转换之后的Person对象p2={name=如花;age=70;sex=未知}

2,创建XStream对象

a)无参构造函数,默认使用XPP3包

  1. //这样创建XStream实例时,上面那3个jar包必须都有
  2. XStream xstream = new XStream();

b)有参构造函数,使用标准的JAXP DOM

  1. //这里不需要XPP3和xmlpull库了,而是使用标准的JAXP DOM解析XML
  2. XStream xstream = new XStream(new DomDriver());

c)有参构造函数,使用StAX解析XML

  1. //这里不需要XPP3库了但是需要你使用java 6
  2. XStream xstream = new XStream(new StaxDriver());

3,将Java对象转换成为XML字符串

String xml = xstream.toXML(p);

结果是:

  1. <?xml version="1.0" ?>
  2. <cn.tjpu.zhw.xml.Person>
  3. <name>如花</name>
  4. <age>70</age>
  5. <sex>未知</sex>
  6. </cn.tjpu.zhw.xml.Person>

4,将XML转换成为Java对象

Person p2 = (Person) xstream.fromXML(xml);

参考文章:http://www.doc88.com/p-091909836812.html

使用XStream是实现XML与Java对象的转换(1)--简介及入门示例的更多相关文章

  1. 使用XStream是实现XML与Java对象的转换(6)--持久化

    九.持久化 在第八节的示例中,当我们操作一组对象时,我们可以指定Writer.OutputStream来写出序列化后的XML数据,我们还可以指定Reader.InputStream来读取序列化后的XM ...

  2. 使用XStream是实现XML与Java对象的转换(4)--转换器

    七.转换器(Converter) 我们程序中的POJO是千变万化的,而且需求也是千奇百怪的,所以XStream中的内置的转换器的功能不一定能够满足我们的要求,所以我们就需要自己构建转换器. 1,一个基 ...

  3. 使用XStream是实现XML与Java对象的转换(3)--注解

    六.使用注解(Annotation) 总是使用XStream对象的别名方法和注册转换器,会让人感到非常的乏味,又会产生很多重复性代码,于是我们可以使用注解的方式来配置要序列化的POJO对象. 1,最基 ...

  4. 使用XStream是实现XML与Java对象的转换(5)--Object Stream

    八,Object Stream 之前的例子我们都是直接输出Xml成为String类型或者从String中获得并解析Xml,现在我们要处理输入流和输出流! 1,输出流(ObjectOutputStrea ...

  5. 使用XStream是实现XML与Java对象的转换(2)--别名

    五.使用别名(Alias) 首先,有这样一段Java代码: import java.util.ArrayList; import java.util.List; import com.thoughtw ...

  6. 不规矩的xml与JAVA对象互相转换的小技巧-使用Marshaller

    摘要:将XML文档与JAVA对象互转是很常见的需求,如果XML定义很规整这很好实现.然而在现实中“不规矩”的XML可能更常见,Marshaller便无能为力了吗?下面是一个小技巧,调整一下思维便能重用 ...

  7. XStream轻松转换xml和java对象

    首先引入所需的jar: xstream-1.4.9.xpp3_min-1.1.4c.dom4j-1.6.1, 或用maven管理jar包时在pom.xml中添加: <!-- https://mv ...

  8. xml-mapping xml 与 java 对象转换映射框架,像 XStream 一样优雅地读写xml

    xml xml 是 java 实现的 xml 框架. 希望以最优雅的方式进行 xml 和 java 之间的转换处理,一行代码搞定一切. 特点 对象的和 xml 的互相映射 支持注解 @Alias 指定 ...

  9. XML 和 java对象相互转换

    XML 和 java对象相互转换 博客分类: XML 和 JSON   下面使用的是JDK自带的类,没有引用任何第三方jar包. Unmarshaller 类使客户端应用程序能够将 XML 数据转换为 ...

随机推荐

  1. 【Android应用开发】Android Studio - MAC 版 - 快捷键详解

    博客地址 : http://blog.csdn.net/shulianghan/article/details/47321177 作者 : 韩曙亮 要点总结 : -- 熟练使用快捷键 : 在任何编程环 ...

  2. C++对C的实用性增强

    #include <iostream> using namespace std; //C语言中的变量都必须在作用域开始的位置定义!! //C++中更强调语言的"实用性" ...

  3. JDK 7中的文件操作的新特性

    文件系统综述 一个文件系统在某种媒介(通常是一个或多个硬盘)上存储和组织文件.如今的大多数文件系统都是以树状结构来存储文件.在树的顶端是一个或多个根节点,在根节点一下,是文件和目录(在Windows系 ...

  4. Java中httpClient中三种超时设置

    本文章给大家介绍一下关于Java中httpClient中的三种超时设置小结 在Apache的HttpClient包中,有三个设置超时的地方: /* 从连接池中取连接的超时时间*/ ConnManage ...

  5. 编译Android 4.4.2源码

    在之前的文章中,和大家分享了在天朝下下载android 4.4.2源码的过程(详见下载android4.4.2源码全过程(附已下载的源码)),现在写下编译的笔记. 虽然在android doc中,有提 ...

  6. Unity UGUI基础之InputField

    InputField(输入域):为文本输入控件,等同于NGUI的Input. 一.InputField组件: Text Component(文本组件):此输入域的文本显示组件,需带有Text组件. T ...

  7. Cocos2D中屏幕分辨率解释

    Cocos2D的坐标(0,0)点在屏幕的左下角,然后x和y的坐标值像右上角逐渐增加. 因为项目一般是横屏(landscape)模式,这表示右上角坐标在3.5寸屏上为(480,320), 在4寸屏上为( ...

  8. 怎样写一个与Windows10 IE11兼容的标准BHO?

    p.MsoNormal,li.MsoNormal,div.MsoNormal { margin: 0cm; margin-bottom: .0001pt; text-align: justify; f ...

  9. (一)php的基本知识和一些注意点

    注意:任何程序,包括php,在运行时都在内存中进行,php代码需要被读取到内存中才能执行. [php的运行方式] 1.通过服务器(例如apache)调用. 2.通过命令行调用(不需要服务器参与,因为没 ...

  10. Using mysqldump for Backups(备份还原数据库实例及参数详细说明)

    官网mysqldump命令如下: Using mysqldump for Backups https://dev.mysql.com/doc/refman/5.7/en/using-mysqldump ...