javax.xml.bind.annotation

Тип аннотации XmlID

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

Отображает свойство JavaBean на ID XML.

Чтобы сохранить ссылочную целостность графа объектов через сериализацию XML, сопровождаемую десериализацией XML, требует, чтобы ссылка на объект была упорядочена по ссылке или включению соответственно. Аннотации @XmlID и @XmlIDREF вместе позволяют специализированное отображение типа свойства JavaBean включением или ссылкой.

Использование

Аннотация @XmlID может использоваться со следующими элементами программы:

• свойство JavaBean
• не статичный, не переходное поле

См. "Спецификацию Пакета" в javax.xml.bind.package javadoc для дополнительной общей информации.

Использование подвергается следующим ограничениям:

• Самое большее одно поле или свойство в class могут быть аннотированы @XmlID.
• Типом свойства JavaBean должен быть java.lang.String.
• Единственные другие аннотации отображения, которые могут использоваться с @XmlID are:@XmlElement и @XmlAttribute.

Пример: тип свойства Map a 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