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

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

Сопоставляет свойство JavaBean с XML-элементом, полученным из имени свойства.

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

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

• свойством JavaBean
• нестатическим, непеременным полем
• внутри XmlElements

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

• Эта аннотация может использоваться со следующими аннотациями: XmlID, XmlIDREF, XmlList, XmlSchemaType, XmlValue, XmlAttachmentRef, XmlMimeType, XmlInlineBinaryData, XmlElementWrapper, XmlJavaTypeAdapter
• если тип свойства JavaBean — это коллекция, массив, индексированное свойство или параметризованный список, и эта аннотация используется с XmlElements, то @XmlElement.type() должно быть DEFAULT.class, так как тип элемента коллекции уже известен.

Свойство JavaBean, снабжённое аннотацией @XmlElement, сопоставляется с локальным элементом в XML Schema-комплексном типе, к которому сопоставлен содержащий класс.

Пример 1: Сопоставление публичного, нестатического, нефинального поля с локальным элементом

//Example: Code fragment
     public class USPrice {
         @XmlElement(name="itemprice")
         public java.math.BigDecimal price;
     }

     <!-- Example: Local XML Schema element -->
     <xs:complexType name="USPrice"/>
       <xs:sequence>
         <xs:element name="itemprice" type="xs:decimal" minOccurs="0"/>
       </sequence>
     </xs:complexType>

Пример 2: Сопоставление поля с ниль-элементом.

//Example: Code fragment
     public class USPrice {
         @XmlElement(nillable=true)
         public java.math.BigDecimal price;
     }

     <!-- Example: Local XML Schema element -->
     <xs:complexType name="USPrice">
       <xs:sequence>
         <xs:element name="price" type="xs:decimal" nillable="true" minOccurs="0"/>
       </sequence>
     </xs:complexType>

Пример 3: Сопоставление поля с ниль-элементом, требующим значения.

//Example: Code fragment
     public class USPrice {
         @XmlElement(nillable=true, required=true)
         public java.math.BigDecimal price;
     }

     <!-- Example: Local XML Schema element -->
     <xs:complexType name="USPrice">
       <xs:sequence>
         <xs:element name="price" type="xs:decimal" nillable="true" minOccurs="1"/>
       </sequence>
     </xs:complexType>

Пример 4: Сопоставление свойства JavaBean с XML-элементом с анонимным типом.

См. пример 6 в @XmlType.

Элементы

name

public abstract String name

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

"##default"

nillable

public abstract boolean nillable

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

false

required

public abstract boolean required

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

false

namespace

public abstract String namespace

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

"##default"

defaultValue

public abstract String defaultValue

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

"\u0000"

type

public abstract Class type

Класс Java, на который есть ссылка.

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

javax.xml.bind.annotation.XmlElement.DEFAULT.class