Spec-Zone .ru спецификации, руководства, описания, API

javax.xml.bind.annotation
Тип аннотации XmlElements

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

Контейнер для многократногоXmlElement аннотации. Многократные аннотации того же самого типа не позволяются на элементе программы. Эта аннотация поэтому служит контейнерной аннотацией для многократного @XmlElements следующим образом:

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

@XmlElements annnotation может использоваться со следующими элементами программы:

• свойство JavaBean
• не статичный, не переходное поле

Эта аннотация предназначается для аннотации свойство набора JavaBean (например, Список).

Использование

Использование подвергается следующим ограничениям:

• Эта аннотация может использоваться со следующими аннотациями:XmlIDREF, @XmlElementWrapper.
• Если @XmlIDREF также определяется на свойстве JavaBean, то каждый @XmlElement.type () должен содержать свойство JavaBean, аннотируемое @XmlID.

См. "Спецификацию Пакета" в javax.xml.bind.package javadoc для дополнительной общей информации.

Пример 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 -->
    ...
     1 
     2.5 
    ...

    <!-- 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

Автор:

• Kohsuke Кавагути, Sun Microsystems, Inc.
• Sekhar Vajjhala, Sun Microsystems, Inc.

См. Также:

XmlElement, XmlElementRef, XmlElementRefs, XmlJavaTypeAdapter

Необходимая Сводка Элемента

XmlElement[]

значение НаборXmlElement аннотации

Деталь элемента

значение

public abstract XmlElement[] value

НаборXmlElement аннотации