XStream 简单使用

特点

• 使用方便 - XStream的API提供了一个高层次外观，以简化常用的用例。

• 无需创建映射 - XStream的API提供了默认的映射大部分对象序列化。

• 性能  - XStream快速和低内存占用，适合于大对象图或系统。

• 干净的XML  - XStream创建一个干净和紧凑XML结果，这很容易阅读。

• 不需要修改对象 - XStream可序列化的内部字段，如私有和最终字段，支持非公有制和内部类。默认构造函数不是强制性的要求。

• 完整对象图支持 - XStream允许保持在对象模型中遇到的重复引用，并支持循环引用。

• 可自定义的转换策略 - 定制策略可以允许特定类型的定制被表示为XML的注册。

• 安全框架 - XStream提供了一个公平控制有关解组的类型，以防止操纵输入安全问题。

• 错误消息 - 出现异常是由于格式不正确的XML时，XStream抛出一个统一的例外，提供了详细的诊断，以解决这个问题。

• 另一种输出格式 - XStream支持其它的输出格式，如JSON。

常见用途

传输, 持久化, 配置, 单元测试

下载

官网下载
http://x-stream.github.io/download.html

或者 maven 引入

<!-- https://mvnrepository.com/artifact/com.thoughtworks.xstream/xstream --><dependency>
    <groupId>com.thoughtworks.xstream</groupId>
    <artifactId>xstream</artifactId>
    <version>1.4.11.1</version></dependency>

记住以下步骤

1. 创建XStream 对象

XStream xstream = new XStream(new StaxDriver());

2.序列化对象到XML

// Object to XML Conversion
String xml = xstream.toXML(student);

3.反序列化XML获得对象。

// XML to Object Conversion
Student student = (Student) xstream.fromXML(xml);

类混叠

用来创建一个类的XML完全限定名称的别名

XStream.alias(String name, Class type)

例如 xstream.alias("student", Student.class);

字段混叠

字段混叠用于创建以XML字段的别名。

XStream.aliasField(String alias, Class definedIn, String fieldName)

例如 xstream.aliasField("name", Student.class, "studentName");

隐式集合混叠

使用的集合是表示在XML无需显示根。例如，在我们的例子中，我们需要一个接一个，但不是在根节点来显示每一个节点。让我们再次修改例子，下面的代码添加到它。

XStream.addImplicitCollection(Class ownerType, String fieldName)

例如 xstream.addImplicitCollection(Student.class, "notes");

属性混叠

属性混叠用于创建一个成员变量作为XML属性序列化。

xstream.useAttributeFor(Student.class, "studentName");
xstream.aliasField("name", Student.class, "studentName");

包混叠

包装混叠用于创建一个类XML的完全限定名称的别名到一个新的限定名称。

xstream.aliasPackage("my.company.xstream", "com.yiibai.xstream");

XStream 注解

XStream 支持使用注解做同样的任务。在前面的章节中，我们已经看到了下面的代码配置。

    // 创建一个类的XML完全限定名称的别名
    xstream.alias("student", Student.class);
    xstream.alias("note", Note.class);

    // 使用的集合是表示在XML无需显示根
    xstream.addImplicitCollection(Student.class, "notes");

    // 成员变量作为XML属性
    xstream.useAttributeFor(Student.class, "studentName");
    // 用于创建以XML字段的别名
    xstream.aliasField("name", Student.class, "studentName");

@XStreamAlias("stu