-
@Retention(RUNTIME) @Target({FIELD,METHOD}) public @interface XmlElementWrapper
XML表現にかかわるラッパー要素を生成します。 これは主に、コレクションにかかわるラッパーXML要素を生成するために使用されることを意図しています。 そのため、この注釈は、次の2つの形式の直列化をサポートしています。//Example: code fragment int[] names; // XML Serialization Form 1 (Unwrapped collection) <names> ... </names> <names> ... </names> // XML Serialization Form 2 ( Wrapped collection ) <wrapperElement> <names> value-of-item </names> <names> value-of-item </names> .... </wrapperElement>
この2つの直列化されたXML形式では、nillable属性を伴う要素の有無によって、nullコレクションを表現できます。
使用法
@XmlElementWrapper
注釈は、次のプログラム要素で使用できます。- JavaBeanプロパティ
- staticでない非一時フィールド
使用には次の制約があります。
- プロパティは、コレクション・プロパティである必要があります。
- この注釈型は、次の注釈型とともに使用できます。
XmlElement
、XmlElements
、XmlElementRef
、XmlElementRefs
、XmlJavaTypeAdapter
。
追加の一般的な情報については、javax.xml.bind.package javadocの「パッケージの仕様」を参照してください。
- 導入されたバージョン:
- 1.6, JAXB 2.0
- 関連項目:
XmlElement
,XmlElements
,XmlElementRef
,XmlElementRefs
-
-
要素の詳細
-
name
String name
XMLラッパー要素の名前です。 デフォルトでは、XMLラッパー要素名は、JavaBeanプロパティ名から派生します。- デフォルト:
- 「##default」
-
-
-
namespace
String namespace
XMLラッパー要素のXMLターゲット名前空間です。値が「##default」の場合、名前空間は次のように決定されます。
-
それを含むパッケージに
XmlSchema
注釈型があり、それのelementFormDefault
がQUALIFIED
の場合、それを含むクラスの名前空間。 - それ以外の場合、「」(これは、デフォルト名前空間に非修飾要素を生成します)。
- デフォルト:
- 「##default」
-
それを含むパッケージに
-
-