XmlAttachmentRef (Java Platform SE 8 ) (original) (raw)

@Retention(value=RUNTIME)
@Target(value={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="" title="undefined" rel="noopener noreferrer">http://ws-i.org/profiles/basic/1.1/xsd">
xs:complexType
xs:sequence
<xs:element name="body" type="ref:swaRef" minOccurs="0" />

<xs:attribute name="data" type="ref:swaRef" use="optional" />

The above binding supports WS-I AP 1.0 WS-I Attachments Profile Version 1.0.
Since:
JAXB2.0

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2025, Oracle and/or its affiliates. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.