javax.xml.bind.annotation

Annotation Type XmlElements

@Retention(value=RUNTIME)
 @Target(value={字段,METHOD})
public @interface XmlElements

多个@ XmlElement注释的容器。 程序元素不允许使用相同类型的多个注释。 因此，此注释作为多个@XmlElements的容器注释，如下所示：

  @XmlElements({ @XmlElement(...),@XmlElement(...) }) 

@XmlElements注解可以与以下程序元素一起使用：

• 一个JavaBean属性
• 非静态，非瞬态场

此注释用于注释JavaBean集合属性（例如List）。

用法

用法受以下限制：

• 此注释可以与以下注释一起使用：@ XmlIDREF ，@ XmlElementWrapper 。
• 如果在JavaBean属性中也指定了@XmlIDREF，那么每个@ XmlElement.type（）都必须包含一个带有@XmlID注释的JavaBean属性。

有关其他常见信息，请参阅javax.xml.bind.package javadoc中的“Package Specification”。

示例1：映射到元素列表

  // Mapped code fragment
    public class Foo {
        @XmlElements(
            @XmlElement(name="A", type=Integer.class),
            @XmlElement(name="B", type=Float.class)
         }
         public List items;
    }

    <!-- XML Representation for a List of {1,2.5}
            XML output is not wrapped using another element -->
    ...
    <A> 1 </A>
    <B> 2.5 </B>
    ...

    <!-- XML Schema fragment -->
    <xs:complexType name="Foo">
      <xs:sequence>
        <xs:choice minOccurs="0" maxOccurs="unbounded">
          <xs:element name="A" type="xs:int"/>
          <xs:element name="B" type="xs:float"/>
        <xs:choice>
      </xs:sequence>
    </xs:complexType> 

示例2：映射到包含另一个元素的元素列表

  // Mapped code fragment
    public class Foo {
        @XmlElementWrapper(name="bar")
        @XmlElements(
            @XmlElement(name="A", type=Integer.class),
            @XmlElement(name="B", type=Float.class)
        }
        public List items;
    }

    <!-- XML Schema fragment -->
    <xs:complexType name="Foo">
      <xs:sequence>
        <xs:element name="bar">
          <xs:complexType>
            <xs:choice minOccurs="0" maxOccurs="unbounded">
              <xs:element name="A" type="xs:int"/>
              <xs:element name="B" type="xs:float"/>
            </xs:choice>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType> 

示例3：使用适配器根据类型更改元素名称。

  class Foo {
       @XmlJavaTypeAdapter(QtoPAdapter.class)
       @XmlElements({
           @XmlElement(name="A",type=PX.class),
           @XmlElement(name="B",type=PY.class)
       })
       Q bar;
    }

    @XmlType abstract class P {...}
    @XmlType(name="PX") class PX extends P {...}
    @XmlType(name="PY") class PY extends P {...}

    <!-- XML Schema fragment -->
    <xs:complexType name="Foo">
      <xs:sequence>
        <xs:element name="bar">
          <xs:complexType>
            <xs:choice minOccurs="0" maxOccurs="unbounded">
              <xs:element name="A" type="PX"/>
              <xs:element name="B" type="PY"/>
            </xs:choice>
          </xs:complexType>
        </xs:element>
      </xs:sequence>
    </xs:complexType> 

从以下版本开始：

JAXB2.0

另请参见：

XmlElement ， XmlElementRef ， XmlElementRefs ， XmlJavaTypeAdapter

Required Element Summary

Required Elements

Modifier and Type	Required Element and Description
XmlElement[]	value @ XmlElement注解的集合

Element Detail

value

public abstract XmlElement[] value

收集@ XmlElement注释