Module  java.xml.bind

Annotation Type XmlMixed



  • @Retention(RUNTIME)
    @Target({字段,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 omitted.) 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”。

    从以下版本开始:
    1.6,JAXB 2.0