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

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

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

Позволяет отобразить class на составной тип XML-схемы с simpleContent или XML-схемой простой тип.

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

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

• свойство JavaBean.
• не статичный, не переходное поле.

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

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

• Самое большее одно поле или свойство могут быть аннотированы аннотацией @XmlValue.
• @XmlValue может использоваться со следующими аннотациями: XmlList. Однако это избыточно с тех пор XmlList отображает тип на простой тип схемы, который происходит списком так же, как XmlValue был бы.
• Если тип поля или свойства является типом набора, то тип изделия набора должен отобразиться на простой тип схемы.
• Если тип поля или свойства не является типом набора, то тип должен отобразить на XML-схему простой тип.

Если аннотируемое свойство JavaBean является единственным элементом class, отображаемым на конструкцию XML-схемы, то class отображается на простой тип. Если есть дополнительные свойства JavaBean (кроме свойства JavaBean, аннотируемого аннотацией @XmlValue), которые отображаются на атрибуты XML, то class отображается на составной тип с simpleContent.

Пример 1: Отобразите class на XML-схему simpleType

 
     // Example 1: Code fragment
     public class USPrice {
         @XmlValue
         public java.math.BigDecimal price;
     }
  
     <!-- Example 1: XML Schema fragment -->
     <xs:simpleType name="USPrice">
       <xs:restriction base="xs:decimal"/>
     </xs:simpleType>

   

Пример 2: Отобразите class на XML-схему complexType с с simpleContent.

   // Example 2: Code fragment
   public class InternationalPrice {
       @XmlValue
       public java.math.BigDecimal price;
 
       @XmlAttribute
       public String currency;
   }
  
   <!-- Example 2: XML Schema fragment -->
   <xs:complexType name="InternationalPrice">
     <xs:simpleContent>
       <xs:extension base="xs:decimal">
         <xs:attribute name="currency" type="xs:string"/>
       </xs:extension>
     </xs:simpleContent>
   </xs:complexType> 

   

С тех пор:

JAXB2.0

Автор:

Sekhar Vajjhala, Sun Microsystems, Inc.

См. Также:

XmlType