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

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

用來將屬性映射到列表簡單型別。

用法

@XmlList 註釋能夠與以下程序元素一起使用：

• JavaBean 屬性
• 欄位

在集合屬性僅使用 @XmlElement 進行註釋時，將通過元素包裹集合中的每一個項。例如，

 @XmlRootElement
 class Foo {
     @XmlElement
     List<String> data;
 }
 

將產生如下 XML：

 <foo>
<data>abc</data>
<data>def</data>
 </foo>
 

另一方面，@XmlList 註釋允許將多個值表示為單個元素中以空格分隔的標記。例如，

 @XmlRootElement
 class Foo {
     @XmlElement
     @XmlList
     List<String> data;
 }
 

上述程式碼將產生如下 XML：

 <foo>
<data>abc def</data>
 </foo>
 

此註釋可與以下註釋一起使用：XmlElement、XmlAttribute、XmlValue 和 XmlIDREF。

• 使用 @XmlList 和 XmlValue（在允許的情況下）是多餘的，因為 XmlList 將集合型別映射到一個簡單網要型別，該簡單網要型別就像 XmlValue 那樣是由列表派生的。
• 使用 @XmlList 和 XmlAttribute（在允許的情況下）是多餘的，因為 XmlList 將集合型別映射到一個簡單網要型別，該簡單網要型別就像 XmlAttribute 那樣是由列表派生的。

從以下版本開始：

JAXB2.0