使用XStream註解實現Java對象與XML互相轉換的代碼示例

 本文記錄一下使用xstream這個api的註解特性對Java對象與XML字符串相互轉換的一些代碼示例。
    咱們不少人都處理過XML文件，也有不少很是成熟的第三方開源軟件。如：jdom、dom4j等。雖然他們的功能很是強大，但在使用上仍是有點不那麼習慣。對於格式比較固定的XML文檔，它的結構沒有變化或是不多變化，這時將它轉換成咱們熟悉的Java對象來操做的話，會使工做變得更容易一些，而xstream正好能夠知足這一點。
    本文所用xstream的版本爲：1.4.7

   <dependency>
       <groupId>com.thoughtworks.xstream</groupId>
       <artifactId>xstream</artifactId>
       <version>1.4.7</version>
   </dependency>

    仍是以以前的book XML爲例，先上代碼。

import com.thoughtworks.xstream.annotations.XStreamAlias;
import com.thoughtworks.xstream.annotations.XStreamAsAttribute;

@XStreamAlias("book")
public class Book {

    // 別名註解，這個別名就是XML文檔中的元素名，Java的屬性名不必定要與別名一致
    @XStreamAlias("name")
    private String name;
    
    @XStreamAlias("author")
    private String author;
    
    // 屬性註解，此price就是book的屬性，在XML中顯示爲：<book price="108">
    @XStreamAsAttribute()
    @XStreamAlias("price")
    private String price;

    省略get和set方法
}

 

import java.util.List;

import com.thoughtworks.xstream.annotations.XStreamAlias;
import com.thoughtworks.xstream.annotations.XStreamImplicit;

@XStreamAlias("books")
public class Books {

    // 隱式集合，加上這個註解能夠去掉book集合最外面的<list></list>這樣的標記
    @XStreamImplicit
    private List<Book> list;

    省略get和set方法
}

 

import java.util.List;

import com.thoughtworks.xstream.XStream;
import com.thoughtworks.xstream.io.xml.DomDriver;

public class XStreamHandle {

    private static final String xmlString = "<books><book price=\"108\"><name>Java編程思想</name><author>Bruce Eckel</author></book><book price=\"52\"><name>Effective Java</name><author>Joshua Bloch</author></book><book price=\"118\"><name>Java 7入門經典</name><author>Ivor Horton</author></book></books>";

    public static String toXml(Object obj) {
        XStream xstream = new XStream(new DomDriver("utf8"));
        xstream.processAnnotations(obj.getClass()); // 識別obj類中的註解
        /*
         // 以壓縮的方式輸出XML
         StringWriter sw = new StringWriter();
         xstream.marshal(obj, new CompactWriter(sw));
         return sw.toString();
         */
        // 以格式化的方式輸出XML
        return xstream.toXML(obj);
    }
    
    public static <T> T toBean(String xmlStr, Class<T> cls) {
        XStream xstream = new XStream(new DomDriver());
        xstream.processAnnotations(cls);
        @SuppressWarnings("unchecked")
        T t = (T) xstream.fromXML(xmlStr);
        return t;
    }
    
    public static void main(String[] args) {
        Books books = toBean(xmlString, Books.class);
        List<Book> list = books.getList();
        for(Book book : list) {
            System.out.println("name=" + book.getName() + "\tauthor=" + book.getAuthor()
                    + "\tprice=" + book.getPrice());
        }
        System.out.println(toXml(books));
    }
}

    除了上面示例中用的註解，xstream還有下面幾種註解也常常用到。
    @XstreamOmitField 忽略字段
    這至關於設置某些字段爲臨時屬性，在轉換中再也不起做用。
    @XStreamConverter(XXX.class)  轉換器
    XXX.class是一個實現了com.thoughtworks.xstream.converters.Converter接口的轉換器，對某些類型的值進行轉換，好比布爾值類型的true或false，若是不加轉換器，默認生成的值就是true或false。xstream自帶了BooleanConverter轉換器，能夠將默認值轉換成須要的文本值，若是xstream沒有須要的轉換器就得本身實現Converter接口來自定義轉換器。
    根據大象的經驗，爲了少給本身找麻煩，好比避免使用轉換器，最好將與XML元素或屬性對應的Java對象屬性都設置成String類型，固然列表仍是要定義成List類型的。只要不是特別奇葩，通常狀況下，示例部分就能知足絕大部分的需求。
    本文爲菠蘿大象原創，如要轉載請註明出處。http://www.blogjava.net/bolo