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