使用方法

@XmlElement アノテーションは、次のプログラム要素で使用できます。

• JavaBean プロパティ
• 非静的、非一時的なフィールド
• XmlElements 内

• このアノテーションは、次のアノテーションとともに使用できます: XmlID、XmlIDREF、XmlList、XmlSchemaType、XmlValue、XmlAttachmentRef、XmlMimeType、XmlInlineBinaryData、XmlElementWrapper、XmlJavaTypeAdapter
• JavaBean プロパティの型が配列のコレクション型、インデックス付きプロパティ、パラメーター化されたリストであり、このアノテーションが XmlElements で使用される場合、コレクションアイテムの型はすでにわかっているため、@XmlElement.type() は DEFAULT.class である必要があります。

@XmlElement アノテーションが付けられている場合、JavaBean プロパティは、含まれているクラスがマップされている XML スキーマ複合型のローカル要素にマップされます。

例 1: パブリック非静的非 final フィールドをローカル要素にマップします

     //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: フィールドを nillable 要素にマップします。

     //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: フィールドを nillable の必須要素にマップします。

     //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 要素にマップします。

@XmlType の例 6 を参照してください。