-
@Retention(RUNTIME) @Target({FIELD,METHOD}) public @interface XmlAttribute
JavaBeanプロパティをXML属性にマップします。
使用法
@XmlAttribute
注釈は、次のプログラム要素で使用できます。- JavaBeanプロパティ
- フィールド
static finalフィールドは、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: 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: JavaBeanプロパティを、匿名型を使用したXML属性にマップします。
@XmlType
の例7を参照してください。例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>
- 導入されたバージョン:
- 1.6, JAXB 2.0
- 関連項目:
XmlType