| JavaTM 2 Platform Std. Ed. v1.6.0
javax.xml.bind.annotation
Annotation Type XmlList
@Retention(value=RUNTIME)
@Target(value={FIELD,METHOD,PARAMETER})
public @interface XmlList
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:
<![CDATA[
<foo>
<data>abc</data>
<data>def</data>
</foo>
]]>
@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:
<![CDATA[
<foo>
<data>abc def</data>
</foo>
]]>
This annotation can be used with the following annotations:
XmlElement,
XmlAttribute,
XmlValue,
XmlIDREF.
- The use of @XmlList with
XmlValue while
allowed, is redundant since XmlList maps a
collection type to a simple schema type that derives by
list just as XmlValue would.
- The use of @XmlList with
XmlAttribute while
allowed, is redundant since XmlList maps a
collection type to a simple schema type that derives by
list just as XmlAttribute would.
- Since:
- JAXB2.0
Copyright 2003 Sun Microsystems, Inc. All rights reserved
|
