1. JAXB的介紹

2. JAXB中的核心類以及相關類介紹   

3. JAXB中的常用註解介紹

4. 使用演示展示

首先介紹下什麼是JAXB？

JAXB（Java Architecture for XML Binding) 是一項可以根據XML Schema產生Java類的技術。 該過程中，JAXB也提供了將XML例項文件反向生成Java物件樹的方法，並能將Java物件樹的內容重新寫到 XML例項文件。Jaxb 2.0是JDK 1.6的組成部分。我們不需要下載第三方jar包 即可做到輕鬆轉換。

JAXB的核心類有如下三個：

       JAXBContext類，是應用的入口，用於管理XML/Java繫結資訊。

                   該類不能直接建立，只能使用如下方式進行例項化JAXBContext物件：

       Marshaller介面，將Java物件序列化為XML資料。

                  該類是設定轉換為XML資料的熟悉如格式化輸出xml，裝置xml的編碼格式等：

                  Marshaller marshaller = context.createMarshaller();  
                  marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);  
                  marshaller.setProperty(Marshaller.JAXB_ENCODING, encoding);  
                  marshaller.setProperty(Marshaller.JAXB_FRAGMENT, false);

       Unmarshaller介面，將XML資料反序列化為Java物件。

                  反序列化java物件需要用到的例項：

                  Unmarshaller unmarshaller = context.createUnmarshaller();  
                   t = (T) unmarshaller.unmarshal(new StringReader(xml));

使用JAXB常用的註解如下：

• @XmlType，將Java類或列舉型別對映到XML模式型別
• @XmlAccessorType(XmlAccessType.FIELD) ，控制欄位或屬性的序列化。FIELD表示JAXB將自動繫結Java類中的每個非靜態的（static）、非瞬態的（由@XmlTransient標 注）欄位到XML。其他值還有XmlAccessType.PROPERTY和XmlAccessType.NONE。
• @XmlAccessorOrder，控制JAXB 繫結類中屬性和欄位的排序。
• @XmlJavaTypeAdapter，使用定製的介面卡（即擴充套件抽象類XmlAdapter並覆蓋marshal()和unmarshal()方法），以序列化Java類為XML。
• @XmlElementWrapper ，對於陣列或集合（即包含多個元素的成員變數），生成一個包裝該陣列或集合的XML元素（稱為包裝器）。
• @XmlRootElement，將Java類或列舉型別對映到XML元素。
• @XmlElement，將Java類的一個屬性對映到與屬性同名的一個XML元素。
• @XmlAttribute，將Java類的一個屬性對映到與屬性同名的一個XML屬性。

 [email protected]

　　@XmlType用在class類的註解，常與@XmlRootElement，@XmlAccessorType一起使用。它有三個屬性：name、propOrder、namespace，經常使用的只有前兩個屬性。如：

@XmlType(name = "basicStruct", propOrder = {
    "intValue",
    "stringArray",
    "stringValue"
)

在使用@XmlType的propOrder 屬性時，必須列出JavaBean物件中的所有屬性，否則會報錯。

　[email protected]

　　@XmlElement將java物件的屬性對映為xml的節點，在使用@XmlElement時，可通過name屬性改變java物件屬性在xml中顯示的名稱。如：

　[email protected]

　　@XmlRootElement用於類級別的註解，對應xml的跟元素，常與 @XmlType 和 @XmlAccessorType一起使用。如：

　[email protected]

　[email protected]

　　@XmlAccessorType用於指定由java物件生成xml檔案時對java物件屬性的訪問方式。常與@XmlRootElement、@XmlType一起使用。它的屬性值是XmlAccessType的4個列舉值，分　　　別為：

　　XmlAccessType.FIELD:java物件中的所有成員變數

　　XmlAccessType.PROPERTY：java物件中所有通過getter/setter方式訪問的成員變數

　　XmlAccessType.PUBLIC_MEMBER：java物件中所有的public訪問許可權的成員變數和通過getter/setter方式訪問的成員變數

　　XmlAccessType.NONE:java物件的所有屬性都不對映為xml的元素

　　注意：@XmlAccessorType的預設訪問級別是XmlAccessType.PUBLIC_MEMBER，因此，如果java物件中的private成員變數設定了public許可權的getter/setter方法，就不要在　　　private變數上使用@XmlElement和@XmlAttribute註解，否則在由java物件生成xml時會報同一個屬性在java類裡存在兩次的錯誤。同理，如果@XmlAccessorType的訪問許可權　　　為XmlAccessType.NONE，如果在java的成員變數上使用了@XmlElement或@XmlAttribute註解，這些成員變數依然可以對映到xml檔案。

　[email protected]

　　@XmlAccessorOrder用於對java物件生成的xml元素進行排序。它有兩個屬性值：

　　AccessorOrder.ALPHABETICAL：對生成的xml元素按字母書序排序

　　XmlAccessOrder.UNDEFINED:不排序

　[email protected]

　　@XmlTransient用於標示在由java物件對映xml時，忽略此屬性。即，在生成的xml檔案中不出現此元素。

　[email protected]

　　@XmlJavaTypeAdapter常用在轉換比較複雜的物件時，如map型別或者格式化日期等。使用此註解時，需要自己寫一個adapter類繼承XmlAdapter抽象類，並實現裡面的方法。

　　@XmlJavaTypeAdapter(value=xxx.class),value為自己定義的adapter類

　　XmlAdapter如下：

public abstract class XmlAdapter<ValueType,BoundType> {
    // Do-nothing constructor for the derived classes.
    protected XmlAdapter() {}
    // Convert a value type to a bound type.
    public abstract BoundType unmarshal(ValueType v);
    // Convert a bound type to a value type.
    public abstract ValueType marshal(BoundType v);
 }

演示DEMO

工具類：

package com.lgy.xml;

import java.io.StringReader;
import java.io.StringWriter;

import javax.xml.bind.JAXBContext;
import javax.xml.bind.Marshaller;
import javax.xml.bind.Unmarshaller;

public class JaxbUtil {
	/** 
     * JavaBean轉換成xml 
     * 預設編碼UTF-8 
     * @param obj 
     * @param writer 
     * @return  
     */  
    public static String convertToXml(Object obj) {  
        return convertToXml(obj, "UTF-8");  
    }  
  
    /** 
     * JavaBean轉換成xml 
     * @param obj 
     * @param encoding  
     * @return  
     */  
    public static String convertToXml(Object obj, String encoding) {  
        String result = null;  
        try {  
            JAXBContext context = JAXBContext.newInstance(obj.getClass());  
            Marshaller marshaller = context.createMarshaller();  
            marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true);  
            marshaller.setProperty(Marshaller.JAXB_ENCODING, encoding);  
            marshaller.setProperty(Marshaller.JAXB_FRAGMENT, false);
            StringWriter writer = new StringWriter();  
            marshaller.marshal(obj, writer);  
            result = writer.toString();  
        } catch (Exception e) {  
            e.printStackTrace();  
        }  
  
        return result;  
    }  
  
    /** 
     * xml轉換成JavaBean 
     * @param xml 
     * @param c 
     * @return 
     */  
    @SuppressWarnings("unchecked")  
    public static <T> T converyToJavaBean(String xml, Class<T> c) {  
        T t = null;  
        try {  
            JAXBContext context = JAXBContext.newInstance(c);  
            Unmarshaller unmarshaller = context.createUnmarshaller();  
            t = (T) unmarshaller.unmarshal(new StringReader(xml));  
        } catch (Exception e) {  
            e.printStackTrace();  
        }  
  
        return t;  
    }  
}

package com.lgy.xml;

import java.util.Date;

import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlType;

@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement(name="xmlDemo")
@XmlType(propOrder = { "author", "calendar", "price"})
public class XmlDemo {
	@XmlElement(required = true)
	private String author;

	@XmlElement(name = "price_1", required = true)
	private float price;

	@XmlElement
	private Date calendar;

	@XmlAttribute
	private Integer id;

	public String getAuthor() {
		return author;
	}

	public void setAuthor(String author) {
		this.author = author;
	}

	public float getPrice() {
		return price;
	}

	public void setPrice(float price) {
		this.price = price;
	}

	public Date getCalendar() {
		return calendar;
	}

	public void setCalendar(Date calendar) {
		this.calendar = calendar;
	}

	public Integer getId() {
		return id;
	}

	public void setId(Integer id) {
		this.id = id;
	}

	@Override
	public String toString() {
		return "XmlDemo [author=" + author + ", price=" + price + ", calendar=" + calendar + ", id=" + id + "]";
	}
}

package com.lgy.xml;

import java.util.List;

import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlAttribute;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlRootElement;
import javax.xml.bind.annotation.XmlType;
@XmlAccessorType(XmlAccessType.FIELD)
@XmlRootElement(name="Generators")
@XmlType(propOrder = {"generatorsGroups"})
public class Generators {
	@XmlAttribute
	private Integer id;
	
	@XmlElement(required = true)
	private List<GeneratorsGroup> generatorsGroups;

	public Integer getId() {
		return id;
	}

	public void setId(Integer id) {
		this.id = id;
	}

	public List<GeneratorsGroup> getGeneratorsGroups() {
		return generatorsGroups;
	}

	public void setGeneratorsGroups(List<GeneratorsGroup> generatorsGroups) {
		this.generatorsGroups = generatorsGroups;
	}

	@Override
	public String toString() {
		return "Generators [id=" + id + ", generatorsGroups=" + generatorsGroups + "]";
	}
	
}

package com.lgy.xml;

import javax.xml.bind.annotation.XmlAccessType;
import javax.xml.bind.annotation.XmlAccessorType;
import javax.xml.bind.annotation.XmlElement;
import javax.xml.bind.annotation.XmlType;

@XmlAccessorType(XmlAccessType.FIELD)
@XmlType(propOrder = {"test"})
public class GeneratorsGroup {
	@XmlElement(required = true)
	private String test;

	public String getTest() {
		return test;
	}

	public void setTest(String test) {
		this.test = test;
	}

	@Override
	public String toString() {
		return "GeneratorsGroup [test=" + test + "]";
	}
	
	
}