Тип аннотации 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>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 .