Annotation Type XmlAttachmentRef


  • @Retention(RUNTIME)
    @Target({FIELD,METHOD,PARAMETER})
    public @interface XmlAttachmentRef
    Marks a field/property that its XML form is a uri reference to mime content. The mime content is optimally stored out-of-line as an attachment. A field/property must always map to the DataHandler class.

    Usage

     @XmlRootElement
     class Foo {
       @XmlAttachmentRef
       @XmlAttribute
       DataHandler data;
    
       @XmlAttachmentRef
       @XmlElement
       DataHandler body;
     }
     
    The above code maps to the following XML:
    
     <xs:element name="foo" xmlns:ref="http://ws-i.org/profiles/basic/1.1/xsd">
       <xs:complexType>
         <xs:sequence>
           <xs:element name="body" type="ref:swaRef" minOccurs="0" />
         </xs:sequence>
         <xs:attribute name="data" type="ref:swaRef" use="optional" />
       </xs:complexType>
     </xs:element>
     

    The above binding supports WS-I AP 1.0 WS-I Attachments Profile Version 1.0.

    Author:
    Kohsuke Kawaguchi