-
@Retention(RUNTIME) @Target({FIELD,METHOD}) public @interface XmlIDREF
JavaBeanプロパティをXML IDREFにマップします。
XML直列化とそれに続くXML直列化復元を介してオブジェクト・グラフの参照整合性を保持するには、オブジェクト参照を参照または包含によって適切にマーシャリングする必要があります。
@XmlID
注釈型と@XmlIDREF
注釈型を合わせて使用することにより、包含関係または参照によるJavaBeanプロパティの型のマッピングをカスタマイズできるようになります。使用法
@XmlIDREF
注釈は、次のプログラム要素で使用できます。- JavaBeanプロパティ
- staticでない非一時フィールド
追加の一般的な情報については、javax.xml.bind.package javadocの「パッケージの仕様」を参照してください。
使用には次の制約があります。
- フィールドまたはプロパティの型がコレクション型の場合、コレクション項目の型に
@XmlID
で注釈されたプロパティかフィールドが含まれる必要があります。 - フィールドまたはプロパティが単一値の場合、プロパティまたはフィールドの型に、
@XmlID
で注釈されたプロパティまたはフィールドが含まれる必要があります。注: コレクション項目の型、またはプロパティの型(コレクション型以外の場合)がjava.lang.Objectの場合、インスタンスに、
@XmlID
属性で注釈されたプロパティかフィールドが含まれる必要があります。 - この注釈型は、次の注釈型とともに使用できます。
XmlElement
、XmlAttribute
、XmlList
、およびXmlElements
。
例: JavaBeanプロパティを
xs:IDREF
にマップする(つまり、包含関係ではなく参照に基づく)//EXAMPLE: Code fragment public class Shipping { @XmlIDREF public Customer getCustomer(); public void setCustomer(Customer customer); .... }
<!-- Example: XML Schema fragment --> <xs:complexType name="Shipping"> <xs:complexContent> <xs:sequence> <xs:element name="customer" type="xs:IDREF"/> .... </xs:sequence> </xs:complexContent> </xs:complexType>
例2: 次に、包含関係と参照を対比した包括的な例を示します。
// By default, Customer maps to complex type
xs:Customer
public class Customer { // map JavaBean property type toxs:ID
@XmlID public String getCustomerID(); public void setCustomerID(String id); // .... other properties not shown } // By default, Invoice maps to a complex typexs:Invoice
public class Invoice { // map by reference @XmlIDREF public Customer getCustomer(); public void setCustomer(Customer customer); // .... other properties not shown here } // By default, Shipping maps to complex typexs:Shipping
public class Shipping { // map by reference @XmlIDREF public Customer getCustomer(); public void setCustomer(Customer customer); } // at least one class must reference Customer by containment; // Customer instances won't be marshalled. @XmlElement(name="CustomerData") public class CustomerData { // map reference to Customer by containment by default. public Customer getCustomer(); // maps reference to Shipping by containment by default. public Shipping getShipping(); // maps reference to Invoice by containment by default. public Invoice getInvoice(); }<!-- XML Schema mapping for above code frament --> <xs:complexType name="Invoice"> <xs:complexContent> <xs:sequence> <xs:element name="customer" type="xs:IDREF"/> .... </xs:sequence> </xs:complexContent> </xs:complexType> <xs:complexType name="Shipping"> <xs:complexContent> <xs:sequence> <xs:element name="customer" type="xs:IDREF"/> .... </xs:sequence> </xs:complexContent> </xs:complexType> <xs:complexType name="Customer"> <xs:complexContent> <xs:sequence> .... </xs:sequence> <xs:attribute name="CustomerID" type="xs:ID"/> </xs:complexContent> </xs:complexType> <xs:complexType name="CustomerData"> <xs:complexContent> <xs:sequence> <xs:element name="customer" type="xs:Customer"/> <xs:element name="shipping" type="xs:Shipping"/> <xs:element name="invoice" type="xs:Invoice"/> </xs:sequence> </xs:complexContent> </xs:complexType> <xs:element name"customerData" type="xs:CustomerData"/> <!-- Instance document conforming to the above XML Schema --> <customerData> <customer customerID="Alice"> .... </customer> <shipping customer="Alice"> .... </shipping> <invoice customer="Alice"> .... </invoice> </customerData>
例3: リストをIDREF型の繰返し要素にマップする
// Code fragment public class Shipping { @XmlIDREF @XmlElement(name="Alice") public List customers; }
<!-- XML schema fragment --> <xs:complexType name="Shipping"> <xs:sequence> <xs:choice minOccurs="0" maxOccurs="unbounded"> <xs:element name="Alice" type="xs:IDREF"/> </xs:choice> </xs:sequence> </xs:complexType>
例4: リストをIDREF型の要素リストにマップする。
//Code fragment public class Shipping { @XmlIDREF @XmlElements( @XmlElement(name="Alice", type="Customer.class") @XmlElement(name="John", type="InternationalCustomer.class") public List customers; }
<!-- XML Schema fragment --> <xs:complexType name="Shipping"> <xs:sequence> <xs:choice minOccurs="0" maxOccurs="unbounded"> <xs:element name="Alice" type="xs:IDREF"/> <xs:element name="John" type="xs:IDREF"/> </xs:choice> </xs:sequence> </xs:complexType>
- 導入されたバージョン:
- 1.6, JAXB 2.0
- 関連項目:
XmlID