JAXB(Java Architecture for XML Binding) 是一個業界的標準,是一項可以根據XML Schema產生Java類的技術。該過程中,JAXB也提供了將XML實例文檔反向生成Java對象樹的方法,並能將Java對象樹的內容重新寫到XML實例文檔。從另一方面來講,JAXB...
JAXB(Java Architecture for XML Binding) 是一個業界的標準,是一項可以根據XML Schema產生Java類的技術。該過程中,JAXB也提供了將XML實例文檔反向生成Java對象樹的方法,並能將Java對象樹的內容重新寫到XML實例文檔。
從另一方面來講,JAXB提供了快速而簡便的方法將XML模式綁定到Java表示,從而使得Java開發者在Java應用程式中能方便地結合XML數據和處理函數。
JDK中JAXB相關的重要Class和Interface:
JAXBContext類,是應用的入口,用於管理XML/Java綁定信息。
Marshaller介面,將Java對象序列化為XML數據。
Unmarshaller介面,將XML數據反序列化為Java對象。
在JAXB中,將一個Java對象轉換為XML的過程稱之為Marshal,將XML轉換為Java對象的過程稱之為UnMarshal。我們可以通過在 Java 類中標註註解的方式將一個Java對象綁定到一段XML,也就是說,
在Java類中標註一些註解,這些註解定義瞭如何將這個類轉換為XML,怎麼轉換,以及一段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,解決null 或空值標簽不顯示)
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。
@XmlSchema 配置整個包的namespace,這個註解需放在package-info.java文件中。