-
@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