xstream中几个注解的含义和用法(转）

XStream是个很强大的工具，能将Java对象和xml之间相互转化。xstream不在乎java类中成员变量是私有仍是公有，也不在意是否有默认构造函数。它调用方式也很是简单：从xml对象转化为java对象，使用fromXML()方法；从java对象序列化为xml，toXML()便可，很方便。xstream也支持注解方式，这些都是为了简化输出而设计，下面为你们简单说一下这几个注解的含义和用法。

1. 当没有任何注解状况下

public class Cat {
    //名字
    private String name;
    //大小
    private Integer age;
    //玩具球  球具备颜色属性
    private List<Ball> balls;

    Cat(String name,Integer age,List<Ball> balls){
        this.name = name;
        this.age = age;
        this.balls=balls;
    }
    //getter/setter方法 为了赋值使用

 

其中Ball定义以下：

 

public class Ball {
    //颜色
    private String color;

    Ball(String color){
        this.color = color;
    }

 

没有任何注解，输出以下：

 

public static void main(String[] args) throws Exception{
        //初始化cat
        List<Ball> balls = new ArrayList<Ball>();
        balls.add(new Ball("red"));
        Cat cat = new Cat("馄饨",1,balls);
        //初始化结束
        //为了方便查找 将文件制定到D盘cat.xml中
        FileOutputStream fout = new FileOutputStream("D:/cat.xml");
        XStream xs = new XStream();
        xs.toXML(cat,fout);
    }<span style="font-size:14px;">
</span>

获得Cat.xml以下

 

 

<com.timejob.node.Cat>
  <name>馄饨</name>
  <age>1</age>
  <balls>
    <com.timejob.node.Ball>
      <color>red</color>
    </com.timejob.node.Ball>
  </balls>
</com.timejob.node.Cat>

1. @XStreamAlias("cat") 等同于 xstream.alias("cat", Cat.class); 

 

 

@XStreamAlias("cat")  //here
public class Cat {
    //名字
    private String name;
    //大小
    private Integer age;
    //玩具球  球具备颜色属性
    private List<Ball> balls;

 

咱们须要明确给出，哪一个类的注解须要被激活：

 

public static void main(String[] args) throws Exception{
        //初始化cat
        List<Ball> balls = new ArrayList<Ball>();
        balls.add(new Ball("red"));
        Cat cat = new Cat("馄饨",1,balls);
        //初始化结束
        //为了方便查找 将文件制定到D盘cat.xml中
        FileOutputStream fout = new FileOutputStream("D:/cat.xml");
        XStream xs = new XStream();
        //xs.alias("cat", Cat.class); //等同于 @XStreamAlias("cat")
        xs.processAnnotations(Cat.class);//将Cat.class类上的注解将会使用
        xs.toXML(cat,fout);
    }

当咱们在Cat类名使用该注解时，代表该类序列化为xml时，类名com.timejob.node.Cat将替换成cat输出，这样使得xml更清晰简短：

 

 

<cat>
  <name>馄饨</name>
  <age>1</age>
  <balls>
    <com.timejob.node.Ball>
      <color>red</color>
    </com.timejob.node.Ball>
  </balls>
</cat>

2. XStreamAsAttribute 做用是将类内成员做为父节点属性输出，等同于xstream.useAttributeFor(Cat.class, "name")

 

 

@XStreamAlias("cat")
public class Cat {
    //名字
    @XStreamAsAttribute // here  将name做为Cat属性输出在父节点
    private String name;
    //大小
    private Integer age;
    //玩具球  球具备颜色属性
    private List<Ball> balls;

其余代码保持不变，输出后cat.xml以下：

 

 

<cat name="馄饨">
  <age>1</age>
  <balls>
    <com.timejob.node.Ball>
      <color>red</color>
    </com.timejob.node.Ball>
  </balls>
</cat>

咱们看到name属性已经做为 cat的属性输出在根节点上

 

3. @XStreamAlias 做用就是将属性按照别名输出，等同于xstream.aliasField("catAge", Cat.class, "age");

 

@XStreamAlias("cat")
public class Cat {
    //名字
    @XStreamAsAttribute
    private String name;
    //大小
    @XStreamAlias("catAge")  //here
    private Integer age;
    //玩具球  球具备颜色属性
    private List<Ball> balls;

获得cat.xml文件以下：

 

 

<cat name="馄饨">
  <catAge>1</catAge>
  <balls>
    <com.timejob.node.Ball>
      <color>red</color>
    </com.timejob.node.Ball>
  </balls>
</cat>

4.对于集合经常使用的注解 @XStreamImplicit 去除<Balls></Balls>显示，只显示之间的<Ball></Ball>节点元素

 

@XStreamAlias("cat")
public class Cat {
    //名字
    @XStreamAsAttribute
    private String name;
    //大小
    @XStreamAlias("catAge")
    private Integer age;
    //玩具球  球具备颜色属性
    @XStreamImplicit    //here
    private List<Ball> balls;

 

此时输出以下：

 

<cat name="馄饨">
  <catAge>1</catAge>
  <com.timejob.node.Ball>
    <color>red</color>
  </com.timejob.node.Ball>
</cat>

这样看起来就更加简洁了。

 

4.还有几个注解，都是比较好理解的，如@XStreamOmitField 代表该属性不会被序列化到xml中。

 

@XStreamAlias("cat")
public class Cat {
    //名字
    @XStreamAsAttribute
    private String name;
    //大小
    @XStreamAlias("catAge")
    private Integer age;
    //玩具球  球具备颜色属性
    @XStreamImplicit
    private List<Ball> balls;
    @XStreamOmitField        //here
    private String noCare;

 

 

经常使用的就这么几个，其余的再讨论和学习吧。