Module  java.xml.bind

Annotation Type XmlID



  • @Retention(RUNTIME)
    @Target({字段,METHOD})
    public @interface XmlID

    将JavaBean属性映射到XML ID。

    为了保持XML序列化之后的XML反序列化对象图的引用完整性,需要通过引用或遏制来对对象引用进行编组。 注释@XmlID@XmlIDREF一起允许通过遏制或引用定制映射JavaBean属性的类型。

    用法

    @XmlID注释可以与以下程序元素一起使用:
    • 一个JavaBean属性
    • 非静态,非瞬态场

    有关其他常见信息,请参阅javax.xml.bind.package javadoc中的“Package Specification”。

    用法受以下限制:
    • 类中最多可以注释一个字段或属性,其中可以注释为@XmlID
    • JavaBean属性的类型必须是java.lang.String
    • 可以与@XmlID一起使用的唯一其他映射注释是: @XmlElement@XmlAttribute

    示例 :将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>  
    从以下版本开始:
    1.6,JAXB 2.0
    另请参见:
    XmlIDREF