javax.xml.bind.annotation

Annotation Type XmlID

@Retention(value=RUNTIME)
 @Target(value={字段,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> 

从以下版本开始：

JAXB2.0

另请参见：

XmlIDREF