Package jakarta.xml.bind.annotation

Annotation Interface XmlAttribute

@Retention(RUNTIME)
@Target({FIELD,METHOD})
public @interface XmlAttribute

Maps a JavaBean property to an XML attribute.

Usage

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

• JavaBean property
• field

A static final field is mapped to an XML fixed attribute.

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

The usage is subject to the following constraints:

• If type of the field or the property is a collection type, then the collection item type must be mapped to schema simple type.
• If the type of the field or the property is a non collection type, then the type of the property or field must map to a simple schema type.
• This annotation can be used with the following annotations: XmlID, XmlIDREF, XmlList, XmlSchemaType, XmlValue, XmlAttachmentRef, XmlMimeType, XmlInlineBinaryData, XmlJavaTypeAdapter.

Example 1: Map a JavaBean property to an XML attribute.

Example 2: Map a JavaBean property to an XML attribute with anonymous type.

See Example 7 in @XmlType.

Example 3: Map a JavaBean collection property to an XML attribute.

Since:

1.6, JAXB 2.0

Author:

Sekhar Vajjhala, Sun Microsystems, Inc.

See Also:

• XmlType

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element	Description
String	name	Name of the XML Schema attribute.
String	namespace	Specifies the XML target namespace of the XML Schema attribute.
boolean	required	Specifies if the XML Schema attribute is optional or required.

Element Details

name

String name

Name of the XML Schema attribute. By default, the XML Schema attribute name is derived from the JavaBean property name.

Default:

"##default"

required

boolean required

Specifies if the XML Schema attribute is optional or required. If true, then the JavaBean property is mapped to an XML Schema attribute that is required. Otherwise, it is mapped to an XML Schema attribute that is optional.

Default:

false

namespace

String namespace

Specifies the XML target namespace of the XML Schema attribute.

Default:

"##default"