Used to map a property to a list simple type.
would produce XML like this:
XmlList annotation, on the other hand, allows multiple values to be
represented as whitespace-separated tokens in a single element. For example,
the above code will produce XML like this:
Usage
The @XmlList
annotation can be used with the
following program elements:
- JavaBean property
- field
When a collection property is annotated just with @XmlElement, each item in the collection will be wrapped by an element. For example,
@XmlRootElement
class Foo {
@XmlElement
List<String> data;
}
<foo>
<data>abc</data>
<data>def</data>
</foo>
@XmlRootElement
class Foo {
@XmlElement
@XmlList
List<String> data;
}
<foo>
<data>abc def</data>
</foo>
This annotation can be used with the following annotations:
XmlElement
,
XmlAttribute
,
XmlValue
,
XmlIDREF
.
- The use of
@XmlList
withXmlValue
while allowed, is redundant sinceXmlList
maps a collection type to a simple schema type that derives by list just asXmlValue
would. - The use of
@XmlList
withXmlAttribute
while allowed, is redundant sinceXmlList
maps a collection type to a simple schema type that derives by list just asXmlAttribute
would.
- Author:
- Kohsuke Kawaguchi, Sun Microsystems, Inc.
- Sekhar Vajjhala, Sun Microsystems, Inc.