©
This document uses PHP Chinese website manual Release
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
java.lang.Object javax.xml.soap.SOAPMessage
public abstract class SOAPMessage
所有 SOAP 消息的根类。因为 SOAP 消息是通过“导线”传输的,所以它是 XML 文档或第一个正文部分为 XML/SOAP 文档的 MIME 消息。
SOAPMessage
对象由一个 SOAP 部分和一个或多个附件部分(可选)组成。SOAPMessage
对象的 SOAP 部分是一个 SOAPPart
对象,包含了用于消息路由和标识的信息,并可以包含特定于应用程序的内容。消息 SOAP 部分中的所有数据都必须是 XML 格式。
默认情况下,新的 SOAPMessage
对象包含以下对象:
SOAPPart
对象
SOAPEnvelope
对象
SOAPBody
对象
SOAPHeader
对象
SOAPMessage.getSOAPPart()
检索消息的 SOAP 部分。SOAPEnvelope
对象是从 SOAPPart
对象检索的,SOAPEnvelope
对象用于检索 SOAPBody
和 SOAPHeader
对象。
SOAPPart sp = message.getSOAPPart(); SOAPEnvelope se = sp.getEnvelope(); SOAPBody sb = se.getBody(); SOAPHeader sh = se.getHeader();
除强制性 SOAPPart
对象之外,SOAPMessage
对象还可以包含零个或多个 AttachmentPart
对象,每个 AttachmentPart 对象都包含特定于应用程序的数据。SOAPMessage
接口提供了一些用于创建 AttachmentPart
对象的方法,以及一些将它们添加到 SOAPMessage
对象的方法。收到 SOAPMessage
对象的一方可以通过检索各个附件部分来检查消息内容。
与 SOAP 消息的其余部分不同,附件不需要是 XML 格式,因此可以是简单文本或图像文件等任何形式。因此,任何非 XML 格式的消息内容必须在 AttachmentPart
对象中。
MessageFactory
对象可以创建行为特定于具体 SAAJ 实现或应用程序的 SOAPMessage
对象。例如,MessageFactory
对象可以生成符合特定配置文件(如 ebXML)的 SOAPMessage
对象。在这种情况下,MessageFactory
对象可以生成使用 ebXML 头初始化的 SOAPMessage
对象。
为了确保与后向源的兼容性,在 SAAJ 规范的 1.1 版本之后添加到此类的方法都是具体而非抽象的,它们都具有默认实现。除在 JavaDocs 中有对这些方法的另行说明外,默认实现只是抛出 UnsupportedOperationException
,并且 SAAJ 实现代码必须使用提供指定行为的方法重写它们。但是,只要没有声明符合初始版本之后的某些更高版本规范,遗留客户端代码就没有这种限制。可以根据 SAAJ API 的未修改后续版本来编译和/或运行扩展 SOAPMessage 类的遗留类。如果正确实现了这样的类,则对于规范的更高版本(相对于初始版本)来说,该类将继续有效。
MessageFactory
,
AttachmentPart
字段摘要 | |
---|---|
static String |
CHARACTER_SET_ENCODING
指定 SOAP Message 的字符类型编码。 |
static String |
WRITE_XML_DECLARATION
指定 SOAP Message 在发送时是否包含 XML 声明。 |
构造方法摘要 | |
---|---|
SOAPMessage()
|
方法摘要 | |
---|---|
abstract void |
addAttachmentPart(AttachmentPart AttachmentPart)
将给定的 AttachmentPart 对象添加到此 SOAPMessage
对象。 |
abstract int |
countAttachments()
获取此消息中附件数量的计数。 |
abstract AttachmentPart |
createAttachmentPart()
创建一个新的空 AttachmentPart 对象。 |
AttachmentPart |
createAttachmentPart(DataHandler dataHandler)
创建 AttachmentPart 对象并使用给定的 DataHandler 对象填充。 |
AttachmentPart |
createAttachmentPart(Object content,
String contentType)
创建 AttachmentPart 对象并使用指定内容类型的指定数据填充。 |
abstract AttachmentPart |
getAttachment(SOAPElement element)
返回与此 SOAPElement 引用的附件关联的 AttachmentPart 对象,如果不存在此类附件,则返回 null 。 |
abstract Iterator |
getAttachments()
检索所有作为此 SOAPMessage 对象一部分的 AttachmentPart 对象。 |
abstract Iterator |
getAttachments(MimeHeaders headers)
检索所有头条目匹配指定头的 AttachmentPart 对象。 |
abstract String |
getContentDescription()
检索此 SOAPMessage 对象内容的描述。 |
abstract MimeHeaders |
getMimeHeaders()
以与传输无关的方式返回此 SOAPMessage 对象所有特定于传输的 MIME 头。 |
Object |
getProperty(String property)
检索指定属性的值。 |
SOAPBody |
getSOAPBody()
获取此 SOAPMessage 对象中包含的 SOAP Body。 |
SOAPHeader |
getSOAPHeader()
获取此 SOAPMessage 对象中包含的 SOAP Header。 |
abstract SOAPPart |
getSOAPPart()
获取此 SOAPMessage 对象的 SOAP 部分。 |
abstract void |
removeAllAttachments()
移除所有已经添加到此 SOAPMessage 对象的 AttachmentPart 对象。 |
abstract void |
removeAttachments(MimeHeaders headers)
移除所有头条目匹配指定头的 AttachmentPart 对象。 |
abstract void |
saveChanges()
使用对其所作的所有更改更新此 SOAPMessage 对象。 |
abstract boolean |
saveRequired()
指示是否此 SOAPMessage 对象需要调用方法 saveChanges 。 |
abstract void |
setContentDescription(String description)
使用给定描述设置此 SOAPMessage 对象内容的描述。 |
void |
setProperty(String property,
Object value)
将指定值与指定属性关联。 |
abstract void |
writeTo(OutputStream out)
将此 SOAPMessage 对象写入给定输出流。 |
从类 java.lang.Object 继承的方法 |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
字段详细信息 |
---|
public static final String CHARACTER_SET_ENCODING
SOAPMessage.setProperty
,
常量字段值public static final String WRITE_XML_DECLARATION
SOAPMessage.setProperty
,
常量字段值构造方法详细信息 |
---|
public SOAPMessage()
方法详细信息 |
---|
public abstract void setContentDescription(String description)
SOAPMessage
对象内容的描述。
description
- 描述此消息内容的 String
getContentDescription()
public abstract String getContentDescription()
SOAPMessage
对象内容的描述。
String
,如果没有设置描述,则返回 null
setContentDescription(java.lang.String)
public abstract SOAPPart getSOAPPart()
SOAPMessage
对象的 SOAP 部分。
SOAPMessage
对象包含一个或多个附件,SOAP 部分必须是消息中的第一个 MIME 正文部分。
SOAPMessage
对象的 SOAPPart
对象public SOAPBody getSOAPBody() throws SOAPException
SOAPMessage
对象中包含的 SOAP Body。
SOAPMessage
对象包含的 SOAPBody
对象
SOAPException
- 如果 SOAP Body 不存在或无法被检索public SOAPHeader getSOAPHeader() throws SOAPException
SOAPMessage
对象中包含的 SOAP Header。
SOAPMessage
对象包含的 SOAPHeader
对象
SOAPException
- 如果 SOAP Header 不存在或无法被检索public abstract void removeAllAttachments()
SOAPMessage
对象的 AttachmentPart
对象。
此方法不接触 SOAP 部分。
public abstract int countAttachments()
SOAPMessage
对象一部分的 AttachmentPart
对象的数量public abstract Iterator getAttachments()
SOAPMessage
对象一部分的 AttachmentPart
对象。
public abstract Iterator getAttachments(MimeHeaders headers)
AttachmentPart
对象。注意,返回的附件除指定的头之外,还可以有其他头。
headers
- 包含要搜索的 MIME 头的 MimeHeaders
对象
public abstract void removeAttachments(MimeHeaders headers)
AttachmentPart
对象。注意,移除的附件除指定的头之外,还可以有其他头。
headers
- 包含要搜索的 MIME 头的 MimeHeaders
对象public abstract AttachmentPart getAttachment(SOAPElement element) throws SOAPException
SOAPElement
引用的附件关联的 AttachmentPart
对象,如果不存在此类附件,则返回 null
。可以通过 SOAP Messages with Attachments 中描述的 href
属性,或者包含 WS-I Attachments Profile 1.0(用于模式类型 ref:swaRef(ref:swaRef) 的元素)中所描述的 URI 的一个 Text
子节点来进行引用。必须支持这两种机制。支持通过 href
属性获取引用同时意味着,对于作为 xop:Include 元素 (XOP) 的元素也应该支持此方法。其他引用机制可以由此标准的各个实现支持。有关详细信息,请与您的供应商联系。
element
- 包含对附件引用的 SOAPElement
AttachmentPart
;如果不存在此类 AttachmentPart
或在此 SOAPElement
中找不到引用,则返回 null。
SOAPException
- 如果尝试访问附件时出现错误public abstract void addAttachmentPart(AttachmentPart AttachmentPart)
AttachmentPart
对象添加到此 SOAPMessage
对象。必须先创建 AttachmentPart
对象,然后才能将其添加到消息。
AttachmentPart
- 将作为此 SOAPMessage
对象一部分的 AttachmentPart
对象
IllegalArgumentException
public abstract AttachmentPart createAttachmentPart()
AttachmentPart
对象。注意,调用方法 addAttachmentPart
时必须将此新 AttachmentPart
对象作为参数,以便该对象成为此 SOAPMessage
对象的附件。
SOAPMessage
对象的新的 AttachmentPart
对象public AttachmentPart createAttachmentPart(DataHandler dataHandler)
AttachmentPart
对象并使用给定的 DataHandler
对象填充。
dataHandler
- 将生成此 SOAPMessage
对象内容的 javax.activation.DataHandler
对象
DataHandler
对象生成数据的新的 AttachmentPart
对象
IllegalArgumentException
- 如果指定的 DataHandler
对象存在问题DataHandler
,
DataContentHandler
public abstract MimeHeaders getMimeHeaders()
SOAPMessage
对象所有特定于传输的 MIME 头。
MimeHeader
对象的 MimeHeaders
对象public AttachmentPart createAttachmentPart(Object content, String contentType)
AttachmentPart
对象并使用指定内容类型的指定数据填充。Object
的类型应该对应于指定给 Content-Type
的值。
content
- 包含要创建的 AttachmentPart
对象内容的 Object
contentType
- 给出内容类型的 String
对象;例如 "text/xml"、"text/plain" 和 "image/jpeg"
AttachmentPart
对象
IllegalArgumentException
- 如果 contentType 不匹配内容对象的类型,或者没有给定内容对象的 DataContentHandler
对象时抛出DataHandler
,
DataContentHandler
public abstract void saveChanges() throws SOAPException
SOAPMessage
对象。调用 writeTo(OutputStream)
时自动调用此方法。但是,如果是对已收到或已发送的消息进行更改,则需要显式调用方法 saveChanges
保存这些更改。方法 saveChanges
还生成任何可以回读的更改(例如,支持消息 id 的配置文件中 MessageId)。只有在调用 saveChanges
之后,才能保证为发送而创建的消息中的所有 MIME 头具有有效值。 此外,此方法标记了位置点,取自所有 AttachmentPart
对象组件的数据在该点处被拉入消息。
SOAPException
- 如果在保存此消息的更改时出现问题。
SOAPException
public abstract boolean saveRequired()
SOAPMessage
对象需要调用方法 saveChanges
。
saveChanges
,则返回 true
;否则返回 false
。public abstract void writeTo(OutputStream out) throws SOAPException, IOException
SOAPMessage
对象写入给定输出流。具体化格式在 SOAP 1.1 with Attachments 规范中定义。 如果没有附件,则只写出 XML 流。对于有附件的消息,writeTo
写出 MIME 编码的字节流。
注意,此方法不写出特定于传输的消息的 MIME Header
out
- SOAPMessage
对象将写入的 OutputStream
对象
IOException
- 如果发生 I/O 错误
SOAPException
- 在具体化此 SOAP 消息时出现问题public void setProperty(String property, Object value) throws SOAPException
有效属性名包括 WRITE_XML_DECLARATION
和 CHARACTER_SET_ENCODING
。所有这些标准 SAAJ 属性都以 "javax.xml.soap" 为前缀。供应商也可以添加特定于实现的属性。这些属性必须以供应商所独有的包名称为前缀。
将属性 WRITE_XML_DECLARATION
设置为 "true"
会导致在 SOAP 消息的起始处写出 XML Declaration。默认值 "false" 表示取消此声明。
属性 CHARACTER_SET_ENCODING
默认为值 "utf-8"
,该值将导致使用 UTF-8 编码 SOAP 消息。将 CHARACTER_SET_ENCODING
设置为 "utf-16"
将导致使用 UTF-16 编码 SOAP 消息。
某些实现可能允许除 UTF-8 和 UTF-16 之外的编码。有关详细信息,请参阅供应商文档。
property
- 要关联指定值的属性。value
- 要与指定属性关联的值
SOAPException
- 如果无法识别属性名。public Object getProperty(String property) throws SOAPException
property
- 要检索的属性名称
null
。
SOAPException
- 如果无法识别属性名。
|
JavaTM 2 Platform Standard Ed. 6 |
|||||||||
上一个类 下一个类 | 框架 无框架 | |||||||||
摘要: 嵌套 | 字段 | 构造方法 | 方法 | 详细信息: 字段 | 构造方法 | 方法 |
版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。