Used to map a property to a list simple type.
Usage
The @XmlList annotation can be used with the
following program elements:
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;
}
would produce XML like this:
abc
def
@XmlList annotation, on the other hand, allows multiple values to be
represented as whitespace-separated tokens in a single element. For example,
@XmlRootElement
class Foo {
@XmlElement
@XmlList
List<String> data;
}
the above code will produce XML like this:
abc def
This annotation can be used with the following annotations:
{@link XmlElement},
{@link XmlAttribute},
{@link XmlValue},
{@link XmlIDREF}.
- The use of @XmlList with {@link XmlValue} while
allowed, is redundant since {@link XmlList} maps a
collection type to a simple schema type that derives by
list just as {@link XmlValue} would.
- The use of @XmlList with {@link XmlAttribute} while
allowed, is redundant since {@link XmlList} maps a
collection type to a simple schema type that derives by
list just as {@link XmlAttribute} would.
|