javax.xml.bind.annotation

注釈型XmlList

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

プロパティをリスト単純型にマップするために使用されます。

使用法

@XmlList注釈は、次のプログラム要素で使用できます。

• JavaBeanプロパティ
• フィールド

コレクション・プロパティが@XmlElementだけで注釈されている場合、コレクション内の各項目が1つの要素によってラップされます。次に例を示します。

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

この場合、次のようなXMLが生成されます。

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

一方、@XmlList注釈を使用した場合、単一の要素内で空白で区切られたトークンとして複数の値を表現できます。次に例を示します。

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

上記のコードでは、次のようなXMLが生成されます。

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

この注釈型は、次の注釈型とともに使用できます。XmlElement、XmlAttribute、XmlValue、XmlIDREF。

• @XmlListをXmlValueとともに使用すること(これが可能な場合)は冗長です。XmlListは、XmlValueと同様に、リストから派生した単純スキーマ型にコレクション型をマップするためです。
• @XmlListをXmlAttributeとともに使用すること(これが可能な場合)は冗長です。XmlListは、XmlAttributeと同様に、リストから派生した単純スキーマ型にコレクション型をマップするためです。

導入されたバージョン:

JAXB2.0