Spec-Zone .ru спецификации, руководства, описания, API

javax.xml.bind.annotation
Тип аннотации 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>
   <data>def</data>
 </foo>
 

Аннотация @XmlList, с другой стороны, позволяет многократным значениям быть представленными как разделенные от пробела маркеры в единственном элементе. Например,

 @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 был бы.

С тех пор:

JAXB2.0

Автор:

• Kohsuke Кавагути, Sun Microsystems, Inc.
• Sekhar Vajjhala, Sun Microsystems, Inc.