JavaTM Platform
Standard Ed. 6

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


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

将 JavaBean 属性映射到 XML 属性。

用法

@XmlAttribute 注释能够与下列程序元素一起使用:

一个 static final 字段将被映射到 XML fixed 属性。

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

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

示例 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"

JavaTM Platform
Standard Ed. 6

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

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