機械翻訳について

javax.xml.bind.annotation

注釈型XmlElementWrapper

@Retention(value=RUNTIME)
 @Target(value={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の「パッケージの仕様」を参照してください。

導入されたバージョン:

JAXB2.0

関連項目:

XmlElement, XmlElements, XmlElementRef, XmlElementRefs

オプション要素のサマリー

オプションの要素

修飾子と型	オプション要素	説明
String	name	XMLラッパー要素の名前です。
String	namespace	XMLラッパー要素のXMLターゲット名前空間です。
boolean	nillable	trueの場合、xsi:nil='true'を使用することによって、コレクションの不在が表現されます。
boolean	required	ラッパー要素宣言をカスタマイズしてrequiredにします。

要素の詳細

name

public abstract String name

XMLラッパー要素の名前です。 デフォルトでは、XMLラッパー要素名は、JavaBeanプロパティ名から派生します。

デフォルト:

「##default」

namespace

public abstract String namespace

XMLラッパー要素のXMLターゲット名前空間です。

値が「##default」の場合、名前空間は次のように決定されます。

1. それを含むパッケージにXmlSchema注釈型があり、それのelementFormDefaultがQUALIFIEDの場合、それを含むクラスの名前空間。
2. それ以外の場合、「」(これは、デフォルト名前空間に非修飾要素を生成します)。

デフォルト:

「##default」

nillable

public abstract boolean nillable

trueの場合、xsi:nil='true'を使用することによって、コレクションの不在が表現されます。 そうでない場合、この要素がないことによって表現されます。

デフォルト:

false

required

public abstract boolean required

ラッパー要素宣言をカスタマイズしてrequiredにします。

required()がtrueの場合、生成された対応するXMLスキーマ要素宣言には、ラッパー要素が常に期待されることを示すminOccurs="1"が含まれます。

これはスキーマの生成だけに影響を及ぼし、非整列化や整列化の機能には影響しません。 これは、ユーザーがアプリケーションの制約をより適切に表現するための手段にすぎません。

導入されたバージョン:

JAXB 2.1

デフォルト:

false