JavaTM 2 Platform
Standard Ed. 6

javax.xml.bind.annotation
注释类型 XmlValue


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

支持将类映射到带有 simpleContent 的 XML 模式复杂类型或 XML 模式简单类型。

用法:

@XmlValue 注释可以与以下程序元素一起使用:

有关其他公共信息,请参阅 javax.xml.bind.package javadoc 中的“包规范”。

用法受到以下使用约束的限制:

如果已注释的 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


JavaTM 2 Platform
Standard Ed. 6

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策