Module java.xml.bind

软件包 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()和提供的存储为内容id附件二进制内容检索。

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

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

从以下版本开始：

1.6，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	描述
AttachmentUnmarshaller()

方法摘要

Modifier and Type	方法	描述
abstract byte[]	getAttachmentAsByteArray(String cid)	检索由content-id（ 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 ，作为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 。 在解组过程中，此值不能更改。

结果

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