モジュール java.xml.bind
パッケージ javax.xml.bind.annotation

注釈型XmlList



  • @Retention(RUNTIME)
    @Target({FIELD,METHOD,PARAMETER})
    public @interface XmlList
    プロパティをリスト単純型にマップするために使用されます。

    使用法

    @XmlList注釈は、次のプログラム要素で使用できます。

    • JavaBeanプロパティ
    • フィールド

    コレクション・プロパティが@XmlElementだけで注釈されている場合、コレクション内の各項目が1つの要素によってラップされます。 次に例を示します。

     @XmlRootElement
     class Foo {
         @XmlElement
         List<String> data;
     }
     
    この場合、次のようなXMLが生成されます。
    
     <foo>
       <data>abc</data>
       <data>def</data>
     </foo>
     
    一方、@XmlList注釈を使用した場合、単一の要素内で空白で区切られたトークンとして複数の値を表現できます。 次に例を示します。
     @XmlRootElement
     class Foo {
         @XmlElement
         @XmlList
         List<String> data;
     }
     
    上記のコードでは、次のようなXMLが生成されます。
    
     <foo>
       <data>abc def</data>
     </foo>
     

    この注釈型は、次の注釈型とともに使用できます。XmlElementXmlAttributeXmlValueXmlIDREF

    • @XmlListXmlValueとともに使用すること(これが可能な場合)は冗長です。XmlListは、XmlValueと同様に、リストから派生した単純スキーマ型にコレクション型をマップするためです。
    • @XmlListXmlAttributeとともに使用すること(これが可能な場合)は冗長です。XmlListは、XmlAttributeと同様に、リストから派生した単純スキーマ型にコレクション型をマップするためです。
    導入されたバージョン:
    1.6, JAXB 2.0