軟體套件 javax.xml.bind.annotation

定義將 Java 程序元素定製成 XML 網要映射的註釋。

請參見：
描述

介面摘要

DomHandler<ElementT,ResultT extends Result>

在元素（及其子代）與 DOM（或類似物件）表示形式之間相互轉換。

類別摘要

W3CDomHandler	W3C DOM（org.w3c.dom 套件）的 DomHandler 實作。
XmlElement.DEFAULT	在 XmlElement.type() 中使用，用於表示根據屬性簽章推斷出來的型別。
XmlElementDecl.GLOBAL	在 XmlElementDecl.scope() 中使用，指示宣告是全體範圍的。
XmlElementRef.DEFAULT	在 XmlElementRef.type() 中使用，用於表示根據屬性簽章推斷出來的型別。
XmlSchemaType.DEFAULT	在 XmlSchemaType.type() 中使用，用於表示根據屬性簽章推斷出來的型別。
XmlType.DEFAULT	在 XmlType.factoryClass() 中使用，指示處理器方法未被使用或者在具有此 XmlType 的類別中。

列舉摘要

XmlAccessOrder	由 XmlAccessorOrder 使用，用於控制 JAXB 綁定類別中屬性和欄位的排序。
XmlAccessType	由 XmlAccessorType 使用，用於控制欄位或屬性的序列化。
XmlNsForm	XML 網要名稱空間限定的列舉。

註釋型別摘要

XmlAccessorOrder	控制類別中欄位和屬性的排序。
XmlAccessorType	控制預設情況下是否對欄位或 Javabean 屬性進行系列化。
XmlAnyAttribute	將 JavaBean 屬性映射到通配符屬性的映射表中。
XmlAnyElement	將 JavaBean 屬性映射到 XML 資訊集表示形式和/或 JAXB 元素。
XmlAttachmentRef	標記欄位/屬性，其 XML 形式是對 MIME 內容的 URI 參考。
XmlAttribute	將 JavaBean 屬性映射到 XML 屬性。
XmlElement	將 JavaBean 屬性映射到派生於屬性名稱的 XML 元素。
XmlElementDecl	將處理器方法映射到 XML 元素。
XmlElementRef	將 JavaBean 屬性映射到派生於屬性型別的 XML 元素。
XmlElementRefs	標記一個屬性，該屬性參考帶有 XmlElement 或 JAXBElement 的類別。
XmlElements	多個 @XmlElement 註釋的容器。
XmlElementWrapper	產生一個套件裝 XML 表示形式的套件裝器元素。
XmlEnum	將列舉型別 Enum 映射到 XML 表示形式。
XmlEnumValue	將 Enum 型別中的列舉常數映射到 XML 表示形式。
XmlID	將 JavaBean 屬性映射到 XML ID。
XmlIDREF	將 JavaBean 屬性映射到 XML IDREF。
XmlInlineBinaryData	禁止對綁定到 XML 中 base64-encoded 二進制資料的資料型別進行 XOP 編碼。
XmlList	用來將屬性映射到列表簡單型別。
XmlMimeType	關聯控制屬性 XML 表示形式的 MIME 型別。
XmlMixed	註釋 JavaBean 多值屬性，以支持混合內容。
XmlNs	關聯名稱空間前綴與 XML 名稱空間 URI。
XmlRegistry	標記具有 XmlElementDecl 的類別。
XmlRootElement	將類別或列舉型別映射到 XML 元素。
XmlSchema	將套件名稱映射到 XML 名稱空間。
XmlSchemaType	將 Java 型別映射到一個簡單的網要內置型別。
XmlSchemaTypes	多個 @XmlSchemaType 註釋的容器。
XmlTransient	阻止將 JavaBean 屬性映射到 XML 表示形式。
XmlType	將類別或列舉型別映射到 XML 網要型別。
XmlValue	支持將類別映射到帶有 simpleContent 的 XML 網要複雜型別或 XML 網要簡單型別。

軟體套件 javax.xml.bind.annotation 的描述

定義將 Java 程序元素定製成 XML 網要映射的註釋。

套件規範

下表顯示了可與每個程序元素關聯的 JAXB 映射註釋。

程序元素	JAXB 註釋
包	XmlAccessorOrder XmlAccessorType XmlSchema XmlSchemaType XmlSchemaTypes XmlJavaTypeAdapter XmlJavaTypeAdapters
類別	XmlAccessorOrder XmlAccessorType XmlInlineBinaryData XmlRootElement XmlType XmlJavaTypeAdapter
列舉型別	XmlEnum XmlEnumValue（僅限列舉常數） XmlRootElement XmlType XmlJavaTypeAdapter
JavaBean 屬性/欄位	XmlElement XmlElements XmlElementRef XmlElementRefs XmlElementWrapper XmlAnyElement XmlAttribute XmlAnyAttribute XmlTransient XmlValue XmlID XmlIDREF XmlList XmlMixed XmlMimeType XmlAttachmentRef XmlInlineBinaryData XmlElementDecl（僅用於方法） XmlJavaTypeAdapter
參數	XmlList XmlAttachmentRef XmlMimeType XmlJavaTypeAdapter

術語

JavaBean 屬性和欄位： 從映射的用途考慮，欄位和 JavaBean 屬性之間沒有語義上的差別。因此，可以應用於 JavaBean 屬性的註釋總是可以應用於欄位。簡言之，在 Javadoc 文檔中，使用術語 JavaBean 屬性或屬性表示 JavaBean 屬性或欄位。如有需要，兩者可以不加區別的同時使用。

頂層類別： 從映射的用途考慮，頂層類別和靜態巢狀類別之間沒有語義上的差別。因此，可以應用於頂層類別的註釋總是可以應用於巢狀靜態類別。簡言之，在 Javadoc 文檔中，使用術語“頂層類別”或類別表示頂層類別或巢狀靜態類別。

映射註釋：JAXB 2.0 基於 JSR 175 程式註釋工具定義的程序註釋。

公共用法約束

在這裡定義以下用法約束，因為它們並不僅限於供註釋使用：

• 對於屬性，給出的註釋可以應用於 read 或 write 屬性，但不能同時應用於二者。
• 屬性名稱必須不同於將被映射類別的任何父級類別中的其他任何屬性名稱。
• 一個類別中映射屬性的映射欄位名稱或取消大寫化的名稱必須唯一。

計數法

名稱空間前綴

在此套件中，以下名稱空間前綴用於 XML 網要片段。

前綴	名稱空間	註釋
xs	http://www.w3.org/2001/XMLSchema	XML 網要名稱空間的名稱空間
ref	http://ws-i.org/profiles/basic/1.1/xsd	swaref 網要元件的名稱空間
xsi	http://www.w3.org/2001/XMLSchema-instance	實例的 XML 網要名稱空間

從以下版本開始：

JAXB 2.0