Тип аннотации XmlElementWrapper

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

Создаёт оберточный элемент вокруг XML-представления. В основном предназначен для создания оберточного XML-элемента вокруг коллекций. Поэтому аннотация поддерживает два формата сериализации, показанных ниже.

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

Два формата сериализованного XML позволяют представлять нулевую коллекцию либо отсутствием элемента, либо наличием элемента с атрибутом nillable.

Использование

Аннотация @XmlElementWrapper может использоваться со следующими элементами программы:

• Свойство JavaBean
• Нестатическое, не транзитивное поле

Использование подчиняется следующим ограничениям:

• Свойство должно быть свойством коллекции
• Данная аннотация может использоваться со следующими аннотациями: XmlElement, XmlElements, XmlElementRef, XmlElementRefs, XmlJavaTypeAdapter.

Дополнительную общую информацию см. в разделе «Спецификация пакета» в документации javax.xml.bind.

Подробное описание элементов

name

public abstract String name

Имя XML-оберточного элемента. По умолчанию имя XML-оберточного элемента выводится из имени свойства JavaBean.

По умолчанию:

"##default"

namespace

public abstract String namespace

По умолчанию:

"##default"

nillable

public abstract boolean nillable

Если значение true, то отсутствие коллекции представлено с помощью xsi:nil='true'. В противном случае оно представлено отсутствием элемента.

По умолчанию:

false

required

public abstract boolean required

С момента:

JAXB 2.1

По умолчанию:

false