XmlAttachmentRef (Java SE 9 & JDK 9 )
Keywords: javax.xml.bind.annotation.XmlAttachmentRef class

Module java.xml.bind
Package javax.xml.bind.annotation

## 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.

  Since:
    1.6, JAXB 2.0