Module jakarta.xml.bind

Package jakarta.xml.bind.annotation

Annotation Interface 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.