javax.xml.bind.annotation
注釈型 XmlValue

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

simpleContent を含む XML Schema 複合型、または XML Schema 単純型へのクラスのマッピングを可能にします。

使用方法:

@XmlValue 注釈は、次のプログラム要素で使用できます。

• JavaBean プロパティー。
• static でない非一時フィールド。

追加の一般的な情報については、javax.xml.bind.package javadoc の「パッケージの仕様」を参照してください。

使用には次の使用上の制約があります。

• @XmlValue 注釈を指定できるのは、最大 1 つのフィールドまたはプロパティーです。
• @XmlValue は、次の注釈とともに使用できます(XmlList)。しかし、XmlValue と同様、XmlList はリストにより派生した単純スキーマ型に型をマップするため、これは冗長です。
• フィールドまたはプロパティーの型がコレクション型の場合、コレクション項目の型が単純スキーマ型にマップされなければいけません。
• フィールドまたはプロパティーの型がコレクション型以外の場合、その型が XML スキーマ単純型にマップされなければいけません。

注釈された JavaBean プロパティーが XML Schema 作成にマップされる唯一のクラスメンバーである場合、クラスは単純型にマップされます。 XML 属性にマップされる別の JavaBean プロパティー (@XmlValue で注釈された JavaBean プロパティー以外) がある場合、クラスは simpleContent を含む複合型にマップされます。

例 1: XML Schema 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: simpleContent を含む XML Schema complexType へのクラスのマッピング

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

関連項目:

XmlType