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

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

支持將類別映射到帶有 simpleContent 的 XML 網要複雜型別或 XML 網要簡單型別。

用法：

@XmlValue 註釋可以與以下程序元素一起使用：

• JavaBean 屬性。
• 非 static、非 transient 欄位。

有關其他公共資訊，請參閱 javax.xml.bind.package javadoc 中的“套件規範”。

用法受到以下使用約束的限制：

• 可以使用 @XmlValue 註釋註釋最多一個欄位或屬性。
• @XmlValue 可以與以下註釋一起使用：XmlList。但是這是多餘的，因為 XmlList 將型別映射到像 XmlValue 那樣由列表派生的簡單網要型別。
• 如果欄位或屬性的型別是集合型別，那麼集合項型別必須映射到簡單網要型別。
• 如果欄位或屬性的型別不是集合型別，那麼型別必須映射到 XML 網要簡單型別。

如果已註釋的 JavaBean 屬性是映射到 XML 網要建構的唯一類別成員，那麼該類別將被映射到一個簡單型別。 如果存在映射到 XML 屬性的其他 JavaBean 屬性（使用 @XmlValue 註釋註釋的 JavaBean 除外），那麼類別將被映射到帶有 simpleContent 的複雜型別。

範例 1：將類別映射到 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：將類別映射到帶有 simpleContent的 XML 網要 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