Top Description Methods
jakarta.xml.bind.annotation

public @Interface XmlAttachmentRef

extends Annotation
Annotations
@Retention:RUNTIME
@Target:FIELD, METHOD, PARAMETER
Imports
jakarta.activation.DataHandler, java.lang.annotation.Retention, .Target

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
Since
1.6, JAXB 2.0

Method Summary

Inherited from java.lang.annotation.Annotation:
annotationTypeequalshashCodetoString