JAXB

其實Marshal 和 UnMarshal的過程並不複雜，只需要從JAXBContext中獲得Marshaller或Unmarshaller對象，就可以讓JAXB幫我們來進行轉換了。我們需要操作的主要內容是定義一個規則，告訴JAXB如何將一個類、按照什麼樣的格式轉換爲XML，下面是JAXB中主要的一些註解。



@XmlRootElement   將一個Java類映射爲一段XML的根節點

參數：name            定義這個根節點的名稱

         namespace   定義這個根節點命名空間



@XmlAccessorType  定義映射這個類中的何種類型需要映射到XML。可接收四個參數，分別是：

     XmlAccessType.FIELD：映射這個類中的所有字段到XML

     XmlAccessType.PROPERTY：映射這個類中的屬性（get/set方法）到XML

     XmlAccessType.PUBLIC_MEMBER：將這個類中的所有public的field或property同時映射到XML（默認）

     XmlAccessType.NONE：不映射



@XmlElement  指定一個字段或get/set方法映射到XML的節點。如，當一個類的XmlAccessorType 被標註爲PROPERTY時，在某一個沒有get/set方法的字段上標註此註解，即可將該字段映射到XML。

參數：defaultValue  指定節點默認值

        name             指定節點名稱

        namespace    指定節點命名空間

        required         是否必須（默認爲false）

        nillable           該字段是否包含 nillable="true" 屬性（默認爲false）

        type               定義該字段或屬性的關聯類型



@XmlAttribute  指定一個字段或get/set方法映射到XML的屬性。

參數：name             指定屬性名稱

        namespace    指定屬性命名空間

        required         是否必須（默認爲false）



@XmlTransient  定義某一字段或屬性不需要被映射爲XML。如，當一個類的XmlAccessorType 被標註爲PROPERTY時，在某一get/set方法的字段上標註此註解，那麼該屬性則不會被映射。



@XmlType  定義映射的一些相關規則

參數：propOrder        指定映射XML時的節點順序

        factoryClass     指定UnMarshal時生成映射類實例所需的工廠類，默認爲這個類本身

        factoryMethod  指定工廠類的工廠方法

        name               定義XML Schema中type的名稱

        namespace      指定Schema中的命名空間



@XmlElementWrapper  爲數組元素或集合元素定義一個父節點。如，類中有一元素爲List items，若不加此註解，該元素將被映射爲

   <items>...</items>

   <items>...</items>

這種形式，此註解可將這個元素進行包裝，如：

   @XmlElementWrapper(name="items")
   @XmlElement(name="item")
   public List items;

將會生成這樣的XML樣式：

   <items>

       <item>...</item>

       <item>...</item>

   </items>



@XmlJavaTypeAdapter  自定義某一字段或屬性映射到XML的適配器。如，類中包含一個接口，我們可以定義一個適配器（繼承自javax.xml.bind.annotation.adapters.XmlAdapter類），指定這個接口如何映射到XML。