其實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。
JAXB
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.