@RetentionSE(RUNTIMESE)
@TargetSE({FIELDSE,METHODSE})
public @interface XmlAnyElement

JavaBean プロパティを XML 情報セット表現や JAXBElement にマップします。

このアノテーションは、XML コンテンツを Jakarta XML Binding アノテーション付きクラスのインスタンスに非整列化する際の「キャッチオール」プロパティとして機能します。通常は複数値の JavaBean プロパティにアノテーションを付けますが、単一値の JavaBean プロパティでも発生する可能性があります。アンマーシャリング中に、クラスの他の JavaBean プロパティの静的 @XmlElement または @XmlElementRef アノテーションに一致しない各 xml 要素は、この「キャッチオール」プロパティに追加されます。

使用箇所:

 @XmlAnyElement
 public ElementSE[] others;

 // Collection of ElementSE or JAXBElements.
 @XmlAnyElement(lax="true")
 public ObjectSE[] others;

 @XmlAnyElement
 private List<ElementSE> nodes;

 @XmlAnyElement
 private ElementSE node;
 

制限の使用制限

このアノテーションは、XmlElement、XmlAttribute、XmlValue、XmlElements、XmlID、XmlIDREF と相互に排他的です。

クラスとそのスーパークラスには、1 つの XmlAnyElement アノテーション付き JavaBean プロパティしか存在できません。

他のアノテーションとの関連

このアノテーションは XmlJavaTypeAdapter とともに使用できるため、ユーザーは独自のデータ構造を DOM にマップし、DOM を XML に構成することができます。

このアノテーションは、次のように XmlMixed で使用できます。

 // List of java.lang.String or DOM nodes.
 @XmlAnyElement @XmlMixed
 List<Object> others;
 

スキーマから Java への例

次のスキーマは、次の Java クラスを生成します。

 <xs:complexType name="foo">
   <xs:sequence>
     <xs:element name="a" type="xs:int" />
     <xs:element name="b" type="xs:int" />
     <xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
   </xs:sequence>
 </xs:complexType>
 

 class Foo {
   int a;
   int b;
   @XmlAnyElement
   List<Element> any;
 }
 

次のようなインスタンスを非整列化できます

 <foo xmlns:e="extra">
   <a>1</a>
   <e:other />  // this will be bound to DOM, because unmarshalling is orderless
   <b>3</b>
   <e:other />
   <c>5</c>     // this will be bound to DOM, because the annotation doesn't remember namespaces.
 </foo>
 

次のスキーマは、次の Java クラスを生成します。

 <xs:complexType name="bar">
   <xs:complexContent>
   <xs:extension base="foo">
     <xs:sequence>
       <xs:element name="c" type="xs:int" />
       <xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded" />
     </xs:sequence>
   </xs:extension>
 </xs:complexType>
 

 class Bar extends Foo {
   int c;
   // Foo.getAny() also represents wildcard content for type definition bar.
 }
 

次のようなインスタンスを非整列化できます

 <bar xmlns:e="extra">
   <a>1</a>
   <e:other />  // this will be bound to DOM, because unmarshalling is orderless
   <b>3</b>
   <e:other />
   <c>5</c>     // this now goes to Bar.c
   <e:other />  // this will go to Foo.any
 </bar>
 

XmlAnyElement と XmlElementRef の併用

XmlAnyElement アノテーションを XmlElementRef とともに使用して、コンテンツツリーに参加できる追加の要素を指定できます。

次のスキーマは、次の Java クラスを生成します。

 <xs:complexType name="foo">
   <xs:choice maxOccurs="unbounded" minOccurs="0">
     <xs:element name="a" type="xs:int" />
     <xs:element name="b" type="xs:int" />
     <xs:any namespace="##other" processContents="lax" />
   </xs:choice>
 </xs:complexType>
 

 class Foo {
   @XmlAnyElement(lax="true")
   @XmlElementRefs({
     @XmlElementRef(name="a", type="JAXBElement.class")
     @XmlElementRef(name="b", type="JAXBElement.class")
   })
   ListSE<ObjectSE> others;
 }

 @XmlRegistry
 class ObjectFactory {
   ...
   @XmlElementDecl(name = "a", namespace = "", scope = Foo.class)
   JAXBElement<Integer> createFooA( Integer i ) { ... }

   @XmlElementDecl(name = "b", namespace = "", scope = Foo.class)
   JAXBElement<Integer> createFooB( Integer i ) { ... }
 

次のようなインスタンスを非整列化できます

<foo xmlns:e="extra">
  <a>1</a>     // this will unmarshal to a JAXBElement instance whose value is 1.
  <e:other />  // this will unmarshal to a DOM ElementSE.
  <b>3</b>     // this will unmarshal to a JAXBElement instance whose value is 1.
</foo>
 

W3C XML スキーマの「緩い」ワイルドカードエミュレーション

アノテーションの lax 要素は、"lax" ワイルドカードセマンティクスのエミュレーションを有効にします。例: Java ソースコードに次のようなアノテーションが付けられている場合:

 @XmlRootElement
 class Foo {
   @XmlAnyElement(lax=true)
   public ObjectSE[] others;
 }
 

次に、次のドキュメントは次のように非整列化します。

 <foo>
   <unknown />
   <foo />
 </foo>

 Foo foo = unmarshal();
 // 1 for 'unknown', another for 'foo'
 assert foo.others.length==2;
 // 'unknown' unmarshals to a DOM element
 assert foo.others[0] instanceof Element;
 // because of lax=true, the 'foo' element eagerly
 // unmarshals to a Foo object.
 assert foo.others[1] instanceof Foo;