javax.xml.bind.attachment

Class AttachmentUnmarshaller

java.lang.Object

javax.xml.bind.attachment.AttachmentUnmarshaller

public abstract class AttachmentUnmarshaller
extends Object

使用JAXB解包含有优化的二进制数据格式的根文件。

这个API可以有效优化的二进制数据格式和MIME JAXB 2实现基于包处理器之间的协同处理（MTOM / XOP和WS-I AP 1）。JAXB解封包的身体，把包装格式用于MIME基础包处理器实现该抽象类的理解。

这个抽象类标识如果包需要isXOPPackage() XOP处理，并提供存储附件的content-id.二进制内容检索

标识内容的ID，CID，通过getAttachment*(String cid)

• 对于XOP处理，CID的Infoset表示步骤2a在Section 3.2 Interpreting XOP Packages
• 对于WS-I AP 1，CID被确定为一种元素或属性中指定的类型ref:swaRef Section 4.4 Referencing Attachments from the SOAP Envelope

从以下版本开始：

JAXB 2

另请参见：

Unmarshaller.setAttachmentUnmarshaller(AttachmentUnmarshaller)， XML-binary Optimized Packaging， WS-I Attachments Profile Version 1.0.， Describing Media Content of Binary Data in XML

构造方法摘要

构造方法

Constructor and Description
AttachmentUnmarshaller()

方法摘要

Modifier and Type	Method and Description
abstract byte[]	getAttachmentAsByteArray(String cid) 检索附件的内容ID，确定 cid，作为 byte[]
abstract DataHandler	getAttachmentAsDataHandler(String cid) 查找MIME内容的内容ID， cid，返回一个 DataHandler。
boolean	isXOPPackage() 只读属性，返回true如果JAXB配置需要执行XOP处理。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AttachmentUnmarshaller

public AttachmentUnmarshaller()

方法详细信息

getAttachmentAsDataHandler

public abstract DataHandler getAttachmentAsDataHandler(String cid)

查找MIME内容的内容ID，cid，返回一个DataHandler。

返回的DataHandler实例的配置必须满足以下要求的映射约束。

Required Mappings between MIME and Java Types
MIME Type	Java Type
DataHandler.getContentType()	instanceof DataHandler.getContent()
image/gif	java.awt.Image
image/jpeg	java.awt.Image
text/xml or application/xml	javax.xml.transform.Source

注意，可以支持额外的映射。

参数

cid -预计将是一个有效的词汇表的XML架构数据类型 xs:anyURI。如果 isXOPPackage() ==true，必须每 cid: URI方案有效的URI（见 RFC 2387）

结果

一个 DataHandler表示MIME附件。

异常

IllegalArgumentException如果给定CID附件未发现。

getAttachmentAsByteArray

public abstract byte[] getAttachmentAsByteArray(String cid)

检索附件的内容ID，确定cid，作为byte[]

。

参数

cid -预计将是一个有效的词汇表的XML架构数据类型 xs:anyURI。如果 isXOPPackage() ==true，必须每 cid: URI方案有效的URI（见 RFC 2387）

结果

字节[]表示依恋通过CID。

异常

IllegalArgumentException如果给定CID附件未发现。

isXOPPackage

public boolean isXOPPackage()

只读属性，返回true如果JAXB配置需要执行XOP处理。

此方法返回时，在true指定Identifying XOP Documents满足约束。这个值必须不解包过程中的变化。

结果

真正当哑剧语境是XOP文件。