javax.xml.bind.attachment

Class AttachmentUnmarshaller

java.lang.Object

javax.xml.bind.attachment.AttachmentUnmarshaller

public abstract class AttachmentUnmarshaller
extends Object

使JAXB解组合包含优化的二进制数据格式的根文档。

该API可实现JAXB 2.0实现和基于MIME的包处理器（MTOM / XOP和WS-I AP 1.0）之间的优化二进制数据格式的高效协作处理。 JAXB解包一个包的正文，将对所使用的打包格式的理解委托给实现此抽象类的基于MIME的包处理器。

该抽象类标识一个包是否需要XOP处理， isXOPPackage()并提供通过content-id存储为附件的二进制内容的检索。

识别content-id，cid，传递给getAttachment*(String cid)

• 对于XOP处理，cid的信息集表示在Section 3.2 Interpreting XOP Packages中的步骤2a中描述
• 对于WS-I AP 1.0，cid被标识为Section 4.4 Referencing Attachments from the SOAP Envelope中指定的类型ref:swaRef的元素或属性

从以下版本开始：

JAXB 2.0

另请参见：

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) 检索由content-id标识的 cid ， cid ，作为 byte[]
abstract DataHandler	getAttachmentAsDataHandler(String cid) 根据content-id查找MIME内容， cid ，并作为DataHandler返回。
boolean	isXOPPackage() 只读属性，如果JAXB解组器需要执行XOP处理，则返回true。

Methods inherited from class java.lang.Object

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

构造方法详细信息

AttachmentUnmarshaller

public AttachmentUnmarshaller()

方法详细信息

getAttachmentAsDataHandler

public abstract DataHandler getAttachmentAsDataHandler(String cid)

根据content-id查找MIME内容， cid ，并作为DataHandler返回。

返回的DataHandler实例必须配置为满足以下所需的映射constaint。

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 Schema xs:anyURI数据类型的有效词汇表。 如果isXOPPackage() ==true ，它必须是cid: URI方案的有效URI（参见RFC 2387 ）

结果

一个代表 MIME附件的DataHandler。

异常

IllegalArgumentException - 如果找不到给定cid的附件。

getAttachmentAsByteArray

public abstract byte[] getAttachmentAsByteArray(String cid)

检索由content-id标识的cid ， cid ，作为byte[]

。

参数

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

结果

由cid标识的附件的byte []表示。

异常

IllegalArgumentException - 如果找不到给定cid的附件。

isXOPPackage

public boolean isXOPPackage()

只读属性，如果JAXB解组器需要执行XOP处理，则返回true。

当满足Identifying XOP Documents中指定的 true时，此方法返回true 。 在解组过程中，此值不能更改。

结果

当MIME上下文是XOP文档时为真。