javax.xml.bind.annotation
Annotation Type XmlElementWrapper

@Retention(value=RUNTIME)
@Target(value={FIELD,METHOD})
public @interface XmlElementWrapper

Generates a wrapper element around XML representation. This is primarily intended to be used to produce a wrapper XML element around collections. The annotation therefore supports two forms of serialization shown below.

    //Example: code fragment
      int[] names;

    // XML Serialization Form 1 (Unwrapped collection)
    <names> ... </names>
    <names> ... </names>
 
    // XML Serialization Form 2 ( Wrapped collection )
    <wrapperElement>
       <names> value-of-item </names>
       <names> value-of-item </names>
       ....
    </wrapperElement>
 

The two serialized XML forms allow a null collection to be represented either by absence or presence of an element with a nillable attribute.

Usage

The @XmlElementWrapper annotation can be used with the following program elements:

• JavaBean property
• non static, non transient field

The usage is subject to the following constraints:

• The property must be a collection property
• This annotation can be used with the following annotations: XmlElement , XmlElements , XmlElementRef , XmlElementRefs , XmlJavaTypeAdapter
.

See "Package Specification" in javax.xml.bind.package javadoc for additional common information.

Since:

JAXB2.0

See Also:

XmlElement , XmlElements , XmlElementRef , XmlElementRefs

name

public abstract String name

Name of the XML wrapper element. By default, the XML wrapper element name is derived from the JavaBean property name.

Default:

"##default"

namespace

public abstract String namespace

XML target namespace of the XML wrapper element. namespace() must be a valid namespace URI. The default XML namespace is the XML namespace of the enclosing class of the Javabean property.

If the value is "##default", then the namespace is determined as follows:

1. If the enclosing package has XmlSchema annotation, and its elementFormDefault is QUALIFIED , then the namespace of the enclosing class.
2. Otherwise "" (which produces unqualified element in the default namespace.

Default:

"##default"

nillable

public abstract boolean nillable

If true, the absence of the collection is represented by using xsi:nil='true' . Otherwise, it is represented by the absence of the element.

Default:

false