-
@Retention(RUNTIME) @Target({FIELD,METHOD,PARAMETER}) public @interface XmlList
プロパティをリスト単純型にマップするために使用されます。使用法
@XmlList注釈は、次のプログラム要素で使用できます。- JavaBeanプロパティ
- フィールド
コレクション・プロパティが@XmlElementだけで注釈されている場合、コレクション内の各項目が1つの要素によってラップされます。 次に例を示します。
@XmlRootElement class Foo { @XmlElement List<String> data; }この場合、次のようなXMLが生成されます。
一方、@XmlList注釈を使用した場合、単一の要素内で空白で区切られたトークンとして複数の値を表現できます。 次に例を示します。<foo> <data>abc</data> <data>def</data> </foo>@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と同様に、リストから派生した単純スキーマ型にコレクション型をマップするためです。
- 導入されたバージョン:
- 1.6, JAXB 2.0