javax.xml.bind.annotation
註釋型別 XmlElementWrapper

@Retention(value=RUNTIME)
@Target(value={FIELD,METHOD})
public @interface XmlElementWrapper

產生一個套件裝 XML 表示形式的套件裝器元素。 此元素主要用於產生一個套件裝集合的套件裝器 XML 元素。因此，該註釋支持以下兩種形式的序列化。

//Example:code fragment
int[] names;

// XML Serialization Form 1 (Unwrapped collection)
<names> ...</names>
<names> ...</names>
 
// XML Serialization Form 2 ( Wrapped collection )
<wrapperElement>
<names> value-of-item </names>
<names> value-of-item </names>
       ....
</wrapperElement>
 

通過使用或不使用具有 nillable 屬性的元素，兩種序列化的 XML 形式可以表示 null 集合。

使用

@XmlElementWrapper 註釋可以與以下程序元素一起使用：

• JavaBean 屬性
• 非 static、非 transient 欄位

用法受到以下約束的限制：

• 該屬性必須是一個集合屬性
• 此註釋可與以下註釋一起使用：XmlElement、XmlElements、XmlElementRef、XmlElementRefs、XmlJavaTypeAdapter。

有關其他公共訊息，請參閱 javax.xml.bind.package javadoc 中的“套件規範”。

從以下版本開始：

JAXB 2.0

另請參見：

XmlElement, XmlElements, XmlElementRef, XmlElementRefs

可選元素摘要

String	name XML 套件裝器元素的名稱。
String	namespace XML 套件裝器元素的 XML 目標名稱空間。
boolean	nillable 如果為 true，則使用 xsi:nil='true' 表示集合不存在。

name

public abstract String name

XML 套件裝器元素的名稱。預設情況下，XML 套件裝器元素的名稱派生於 JavaBean 屬性名稱。

預設值：

"##default"

namespace

public abstract String namespace

XML 套件裝器元素的 XML 目標名稱空間。

如果該值為 "##default"，則名稱空間通過以下方式確定：

1. 如果封閉包中包含 XmlSchema 註釋，並且其 elementFormDefault 為 QUALIFIED，則名稱空間為封閉類別的名稱空間。
2. 否則名稱空間為 ""（這將導致在預設名稱空間中產生非限定的元素）。

預設值：

"##default"

nillable

public abstract boolean nillable

如果為 true，則使用 xsi:nil='true' 表示集合不存在。否則通過不使用該元素來表示集合不存在。

預設值：

false