Spec-Zone .ru спецификации, руководства, описания, API

javax.xml.bind.annotation
Тип аннотации XmlAttribute

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

Отображает свойство JavaBean на атрибут XML.

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

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

• Свойство JavaBean
• поле

Статическое заключительное поле отображается на XML фиксированный атрибут.

См. "Спецификацию Пакета" в javax.xml.bind.package javadoc для дополнительной общей информации.

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

• Если тип поля или свойства является типом набора, то тип изделия набора должен быть отображен на схему простой тип.

       // Examples
       @XmlAttribute List<Integer> items; //legal
       @XmlAttribute List<Bar> foo; // illegal if Bar does not map to a schema simple type
   

• Если тип поля или свойства является не типом набора, то тип свойства или поля должен отобразиться на простой тип схемы.

       // Examples
       @XmlAttribute int foo; // legal
       @XmlAttribute Foo foo; // illegal if Foo does not map to a schema simple type
   

• Эта аннотация может использоваться со следующими аннотациями: XmlID, XmlIDREF, XmlList, XmlSchemaType, XmlValue, XmlAttachmentRef, XmlMimeType, XmlInlineBinaryData, XmlJavaTypeAdapter
.

Пример 1: свойство Map a JavaBean к атрибуту XML.

     //Example: Code fragment
     public class USPrice { 
         @XmlAttribute
         public java.math.BigDecimal getPrice() {...} ;
         public void setPrice(java.math.BigDecimal ) {...};
     }

     <!-- Example: XML Schema fragment -->
     <xs:complexType name="USPrice">
       <xs:sequence>
       </xs:sequence>
       <xs:attribute name="price" type="xs:decimal"/>
     </xs:complexType>
 

Пример 2: свойство Map a JavaBean к XML приписывает с анонимным типом.

См. Пример 7 вXmlType.

Пример 3: Отобразите свойство набора JavaBean на атрибут XML.

     // Example: Code fragment
     class Foo {
         ...
         @XmlAttribute List<Integer> items;
     } 

     <!-- Example: XML Schema fragment -->
     <xs:complexType name="foo">
         ...
       <xs:attribute name="items">
         <xs:simpleType>
           <xs:list itemType="xs:int"/>
         </xs:simpleType>
     </xs:complexType>

 

С тех пор:

JAXB2.0

Автор:

Sekhar Vajjhala, Sun Microsystems, Inc.

См. Также:

XmlType

Дополнительная Сводка Элемента

java.lang.String	имя Имя атрибута XML-схемы.
java.lang.String	пространство имен Определяет целевое пространство имен XML атрибута XML-схемы.
boolean	необходимый Определяет, является ли атрибут XML-схемы дополнительным или необходимым.

имя

public abstract java.lang.String name

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

Значение по умолчанию:

"##default"

необходимый

public abstract boolean required

Определяет, является ли атрибут XML-схемы дополнительным или необходимым. Если это правда, тогда свойство JavaBean отображается на атрибут XML-схемы, который требуется. Иначе это отображается на атрибут XML-схемы, который является дополнительным.

Значение по умолчанию:

ложь

пространство имен

public abstract java.lang.String namespace

Определяет целевое пространство имен XML атрибута XML-схемы.

Значение по умолчанию:

"##default"