JavaTM 2 Platform
Standard Ed. 6

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


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

将 JavaBean 属性映射到 XML ID。

要在 XML 序列化然后反序列化这一过程中保持对象图形的引用完整性,需要通过使用引用或容器适当地对对象引用进行编组。注释 @XmlID@XmlIDREF 一起使用时允许通过容器或引用来实现 JavaBean 属性类型的自定义映射。

用法

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

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

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

示例:将 JavaBean 属性的类型映射到 xs:ID

    // Example: code fragment
    public class Customer {
        @XmlAttribute
        @XmlID
        public String getCustomerID();
        public void setCustomerID(String id);
        .... other properties not shown 
    }

    <!-- Example: XML Schema fragment -->
    <xs:complexType name="Customer">
      <xs:complexContent>
        <xs:sequence>
          ....
        </xs:sequence>
        <xs:attribute name="customerID" type="xs:ID"/>
      </xs:complexContent>
    </xs:complexType>
 

从以下版本开始:
JAXB2.0
另请参见:
XmlIDREF


JavaTM 2 Platform
Standard Ed. 6

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

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