javax.xml.bind.attachment

Class AttachmentMarshaller

java.lang.Object

javax.xml.bind.attachment.AttachmentMarshaller

public abstract class AttachmentMarshaller
extends Object

使JAXB编组优化存储二进制数据。

这个API可以有效优化的二进制数据格式的JAXB编组过程和MIME基础包处理器之间的合作创造。JAXB实现乘警MIME基础包的根体，将引用的MIME部分创作的MIME基础包处理器实现这种抽象。

XOP处理启用isXOPPackage()为真时。看到addMtomAttachment(DataHandler, String, String)详情。

WS-I附件简介1是由addSwaRefAttachment(DataHandler)叫每个JAXB属性{ HTTP相关的指挥支持：/ / /结构/基本WS-I.org / 1.1 / XSD } swaRef。

从以下版本开始：

JAXB 2

另请参见：

Marshaller.setAttachmentMarshaller(AttachmentMarshaller)， XML-binary Optimized Packaging， WS-I Attachments Profile Version 1.0.

构造方法摘要

构造方法

Constructor and Description
AttachmentMarshaller()

方法摘要

Modifier and Type	Method and Description
abstract String	addMtomAttachment(byte[] data, int offset, int length, String mimeType, String elementNamespace, String elementLocalName) 考虑优化的二进制存储作为附件二 data。
abstract String	addMtomAttachment(DataHandler data, String elementNamespace, String elementLocalName) 考虑优化的二进制存储作为附件的MIME内容 data。
abstract String	addSwaRefAttachment(DataHandler data) 添加MIME data作为附件，附件的内容返回的ID，CID。
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

AttachmentMarshaller

public AttachmentMarshaller()

方法详细信息

addMtomAttachment

public abstract String addMtomAttachment(DataHandler data,
                                         String elementNamespace,
                                         String elementLocalName)

考虑优化的二进制存储作为附件的MIME内容data。

这种方法被称为元帅的过程时isXOPPackage()是true JAXB，每个元素的数据类型是“base64Binary”，在3步中描述的Creating XOP Packages。

该方法的实现者决定是否data应单独或内联base64Binary数据。如果实现选择优化的二进制数据的MIME部分的存储，它是负责将data基于包的哑剧，然后分配一个独特的内容ID，CID，标识MIME部分在MIME消息。此方法返回的CID，使JAXB指挥元帅一XOP元，指的是在编组的二进制数据的地方，CID。当方法返回null，JAXB指挥线作为数据data base64Binary。

此方法的调用方必须满足以下约束。如果包含data元素集商品属性xmime:contentType或者代表datais注释与一个已知的MIME类型JAXB财产/场，data.getContentType()应设置MIME类型。

的elementNamespace和elementLocalName参数提供包含二进制数据的上下文。这个信息可以通过MIME基础包处理器用于确定如果二进制数据应该内联或优化作为附件。

参数

data -代表的数据连接。必须非空。

elementNamespace -元素包围base64Binary数据的命名空间URI。可以是空的，但从来没有空。

elementLocalName -元素的本地名称。总是一个非空有效字符串。

结果

一个有效的内容ID URI（见 RFC 2387），确定含 data附件。否则，空如果附件不加和应该被内联的消息。

另请参见：

XML-binary Optimized Packaging， Describing Media Content of Binary Data in XML

addMtomAttachment

public abstract String addMtomAttachment(byte[] data,
                                         int offset,
                                         int length,
                                         String mimeType,
                                         String elementNamespace,
                                         String elementLocalName)

考虑优化的二进制存储作为附件二data。

由于内容类型是不知道的，附件的MIME内容类型必须设置为“application/octet-stream”。

的elementNamespace和elementLocalName参数提供包含二进制数据的上下文。这个信息可以通过MIME基础包处理器用于确定如果二进制数据应该内联或优化作为附件。

参数

data -代表的数据连接。必须非空。实际的数据区域由 (data,offset,length)元组指定。

胶印中第一个字节数组读入 offset -；必须是非负的且不大于array.length

length -字节数是从给定的数组中读取的；必须是非负的且不大于array.length

mimeType -如果数据有一个MIME类型已知的JAXB，即作为参数传递。如果不知道，“application/octet-stream”。此参数可能永远不会为空。

elementNamespace -元素包围base64Binary数据的命名空间URI。可以是空的，但从来没有空。

elementLocalName -元素的本地名称。总是一个非空有效字符串。

结果

内容标识符URI，CID，含有 data或零附件数据是否应该内联。

另请参见：

addMtomAttachment(DataHandler, String, String)

isXOPPackage

public boolean isXOPPackage()

只读属性，返回true如果JAXB指挥使XOP创作。

此值在编组过程中不能更改。当该值为true，该addMtomAttachment(...)方法被调用时相应的二进制数据类型被元帅过程中遇到。

Marshaller。marshal()必须扔掉时，如果该值为true和XML内容整理违反Creating XOP Pacakges HTTP 1步：/ /两。org / TR / 2005 / rec-xop10-20050125 / # creating_xop_packages。“确保原始XML信息集不包含元素信息项与[命名空间名称]“HTTP：/ /两。org / 2004 / 08 / XOP /包括“和[地方名]包括”

当此方法返回true，元帅中至少一个电话addMtomAttachment(...)返回内容的ID时，MIME基础包处理器必须与应用/ XOP + XML媒体类型在Creating XOP Pacakges 5步所描述的根部分标签。

结果

真正当哑剧语境是XOP包。

addSwaRefAttachment

public abstract String addSwaRefAttachment(DataHandler data)

添加MIME data作为附件，附件的内容返回的ID，CID。

这种方法被称为每个元素/ JAXB元帅过程属性类型{ HTTP：/ / /结构/基本WS-I.org / 1.1 / XSD } swaRef。MIME的包处理器实施这一方法负责将指定的数据的MIME附件，并生成内容的ID，CID，唯一标识附着在MIME基础包。

来电者将返回的内容ID，CID，到XML内容的整理。

参数

data代表要附加数据。必须非空。

结果

必须是一个有效的URI作为CID。必须满足一致性要求r2928 WS-I Attachments Profile Version 1.0.