Module  java.xml.bind

Annotation Type XmlList



  • @Retention(RUNTIME)
    @Target({字段,METHOD,PARAMETER})
    public @interface XmlList
    用于将属性映射到列表简单类型。

    用法

    @XmlList注释可以与以下程序元素一起使用:

    • JavaBean属性
    • 领域

    当一个collection属性只用@XmlElement进行注释时,集合中的每个项目都将被元素包裹。 例如,

      @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所示
    • XmlAttribute同时允许使用@XmlList ,是多余的,因为XmlList将集合类型映射到按列表派生的简单模式类型,就像XmlAttribute那样。
    从以下版本开始:
    1.6,JAXB 2.0