XmlAttachmentRef (Java EE 5)

Java EE API

previous page next page

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: REQUIRED | OPTIONAL

DETAIL: ELEMENT

javax.xml.bind.annotation Annotation Type XmlAttachmentRef

@Retention(value=RUNTIME) @Target(value={FIELD,METHOD,PARAMETER}) public @interface XmlAttachmentRef

Implements: Annotation

@Retention(value=RUNTIME)
@Target(value={FIELD, METHOD, PARAMETER})

标记字段/属性，其 XML 形式是对 MIME 内容的 URI 引用。MIME 内容作为附件被优化存储在行外（out-of-line）。字段/属性必须始终映射到 DataHandler 类。

用法

since

JAXB2.0

英文文档：

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:


 &lt;xs:element name="foo" xmlns:ref="http://ws-i.org/profiles/basic/1.1/xsd"&gt;
   &lt;xs:complextype&gt;
     &lt;xs:sequence&gt;
       &lt;/xs:sequence&gt;&lt;/xs:complextype&gt;&lt;/xs:element&gt;&lt;xs:element name="body" type="ref:swaRef" minoccurs="0"&gt;
     
     &lt;xs:attribute name="data" type="ref:swaRef" use="optional"&gt;
   
 &lt;/xs:attribute&gt;&lt;/xs:element&gt;

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

Since:: JAXB2.0
Author:: Kohsuke Kawaguchi