javax.xml.bind.annotation

Annotation Type XmlMixed

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

注释JavaBean多值属性以支持混合内容。

用法受以下限制：

• 可以与@XmlElementRef，@XmlElementRefs或@XmlAnyElement一起使用

以下内容可以插入到@XmlMixed注释的多值属性中

• XML文本信息项被添加为java.lang.String的值。
• 子元素信息项被添加为JAXBElement的实例，或具有使用@XmlRootElement注释的类的实例。
• 未绑定到JAXB映射类的未知内容将插入为Element 。 （假定用@XmlAnyElement注释的属性）

以下是混合内容的绑定和创建的示例。

  <!-- schema fragment having  mixed content -->
  <xs:complexType name="letterBody" mixed="true">
    <xs:sequence>
      <xs:element name="name" type="xs:string"/>
      <xs:element name="quantity" type="xs:positiveInteger"/>
      <xs:element name="productName" type="xs:string"/>
      <!-- etc. -->
    </xs:sequence>
  </xs:complexType>
  <xs:element name="letterBody" type="letterBody"/>

 // Schema-derived Java code:
 // (Only annotations relevant to mixed content are shown below,
 //  others are ommitted.)
 import java.math.BigInteger;
 public class ObjectFactory {
      // element instance factories
      JAXBElement<LetterBody> createLetterBody(LetterBody value);
      JAXBElement<String>     createLetterBodyName(String value);
      JAXBElement<BigInteger> createLetterBodyQuantity(BigInteger value);
      JAXBElement<String>     createLetterBodyProductName(String value);
      // type instance factory
      LetterBody> createLetterBody();
 } 

  public class LetterBody {
      // Mixed content can contain instances of Element classes
      // Name, Quantity and ProductName. Text data is represented as
      // java.util.String for text.
      @XmlMixed
      @XmlElementRefs({
              @XmlElementRef(name="productName", type=JAXBElement.class),
              @XmlElementRef(name="quantity", type=JAXBElement.class),
              @XmlElementRef(name="name", type=JAXBElement.class)})
      List getContent(){...}
 } 

以下是具有混合内容的XML实例文档

  <letterBody>
 Dear Mr.<name>Robert Smith</name>
 Your order of <quantity>1</quantity> <productName>Baby
 Monitor</productName> shipped from our warehouse. ....
 </letterBody> 

可以使用以下JAXB API调用构建。

  LetterBody lb = ObjectFactory.createLetterBody();
 JAXBElement<LetterBody> lbe = ObjectFactory.createLetterBody(lb);
 List gcl = lb.getContent();  //add mixed content to general content property.
 gcl.add("Dear Mr.");  // add text information item as a String.

 // add child element information item
 gcl.add(ObjectFactory.createLetterBodyName("Robert Smith"));
 gcl.add("Your order of "); // add text information item as a String

 // add children element information items
 gcl.add(ObjectFactory.
                      createLetterBodyQuantity(new BigInteger("1")));
 gcl.add(ObjectFactory.createLetterBodyProductName("Baby Monitor"));
 gcl.add("shipped from our warehouse");  // add text information item 

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

从以下版本开始：

JAXB2.0