javax.xml.bind.annotation
註釋型別 XmlAttribute

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

將 JavaBean 屬性映射到 XML 屬性。

用法

@XmlAttribute 註釋能夠與下列程序元素一起使用：

• JavaBean 屬性
• 欄位

一個 static final 欄位將被映射到 XML fixed 屬性。

有關其他公共資訊，請參閱 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>

 

從以下版本開始：

JAXB2.0

另請參見：

XmlType

可選元素摘要

String	name XML 網要屬性的名稱。
String	namespace 指定 XML 網要屬性的 XML 目標名稱空間。
boolean	required 指定 XML 網要屬性是可選的還是必需的。

name

public abstract String name

XML 網要屬性的名稱。預設情況下，XML 網要屬性名稱派生自 JavaBean 屬性名稱。

預設值：

"##default"

required

public abstract boolean required

指定 XML 網要屬性是可選的還是必需的。如果為 true，則將 JavaBean 屬性映射到必需的 XML 網要屬性。否則，將它映射到可選的 XML 網要屬性。

預設值：

false

namespace

public abstract String namespace

指定 XML 網要屬性的 XML 目標名稱空間。

預設值：

"##default"