FileDocCategorySizeDatePackage
XmlList.javaAPI DocJava SE 6 API2367Tue Jun 10 00:27:04 BST 2008javax.xml.bind.annotation

XmlList

public class XmlList
Used to map a property to a list simple type.

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;
}
would produce XML like this:

<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:

<foo>
<data>abc def</data>
</foo>

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.
author
  • Kohsuke Kawaguchi, Sun Microsystems, Inc.
  • Sekhar Vajjhala, Sun Microsystems, Inc.
since
JAXB2.0

Fields Summary
Constructors Summary
Methods Summary