javax.xml.bind.annotation
주석형 XmlID

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

JavaBean 프로퍼티을 XML ID 에 맵 합니다.

XML 의 직렬화 및 직렬화 복원을 또 있고다 객체 그래프의 참조 무결성을 유지하기 위해(때문에), 참조 또는 포함 관계에 근거해 적절히 객체 참조를 정렬화할 필요가 있습니다. @XmlID 주석과 @XmlIDREF 주석을 맞추어 사용하는 것으로써, 포함 관계 또는 참조에 의한 JavaBean 프로퍼티의 형태의 매핑을 커스터마이즈 할 수 있게 됩니다.

사용법

@XmlID 주석은, 다음의 프로그램 요소로 사용할 수 있습니다.

• JavaBean 프로퍼티
• static 가 아닌 비일시 필드

추가의 일반적인 정보에 대해서는, javax.xml.bind.package javadoc 의 「패키지의 스펙」을 참조해 주세요.

사용에는 다음의 제약이 있습니다.

• @XmlID 로 주석 할 수 있는 것은, 클래스내의 최대 1 개의 필드 또는 프로퍼티입니다.
• 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