请参见:
描述
接口摘要 | |
---|---|
Detail | DetailEntry 对象的容器。 |
DetailEntry | Detail 对象的内容,给出 SOAPFault 对象的详细信息。 |
Name | XML 名称的表示形式。 |
Node | XML 文档中节点(元素)的表示形式。 |
SOAPBody | 表示 SOAP 消息中 SOAP 正文元素内容的对象。 |
SOAPBodyElement | 表示 SOAPBody 对象中内容的 SOAPBodyElement 对象。 |
SOAPConstants | 与 SOAP 协议有关的常量的定义。 |
SOAPElement | 表示 SOAP 规范允许使用但未特别规定的 SOAP 消息元素的对象。 |
SOAPEnvelope | SOAPPart 对象的 SOAPHeader 和 SOAPBody 部分的容器。 |
SOAPFault | SOAPBody 对象中的元素,包含错误和/或状态信息。 |
SOAPFaultElement | SOAPFault 对象内容的表示形式。 |
SOAPHeader | SOAP 头元素的表示形式。 |
SOAPHeaderElement | 表示 SOAP 信封 SOAP 头部分的内容的对象。 |
Text | 值为文本的节点的表示形式。 |
类摘要 | |
---|---|
AttachmentPart | SOAPMessage 对象的一个附件。 |
MessageFactory | 创建 SOAPMessage 对象的工厂。 |
MimeHeader | 存储 MIME 头名称及其值的对象。 |
MimeHeaders | MimeHeader 对象的容器,这些对象表示出现在消息的 MIME 部分的 MIME 头。 |
SAAJMetaFactory | SAAJ API 中定义的工厂实现类的访问点。 |
SAAJResult | 以 SAAJ 树的形式,充当 JAXP 转换或 JAXB 编组结果的持有者。 |
SOAPConnection | 客户端可以用于直接将消息发送到(例如,用 URL 表示的)远程方的点对点连接。 |
SOAPConnectionFactory | 创建 SOAPConnection 对象的工厂。 |
SOAPElementFactory | 已过时。 - 使用 javax.xml.soap.SOAPFactory 创建 SOAPElements。 |
SOAPFactory | SOAPFactory 是用来创建存在于 SOAP XML 树中的各种对象的工厂。 |
SOAPMessage | 所有 SOAP 消息的根类。 |
SOAPPart | SOAPMessage 对象中特定于 SOAP 部分的容器。 |
异常摘要 | |
---|---|
SOAPException | 当发生 SOAP 异常时,抛出此异常。 |
提供用于创建和构建 SOAP 消息的 API。此包在 SOAP with Attachments API for JavaTM (SAAJ) 1.3 规范中进行了定义。
javax.xml.soap
包中的 API 允许执行以下操作:
此外,
javax.xml.soap
包中的 API 在
org.w3c.dom
包中扩展了它们的对等项。这意味着
SOAPMessage
的
SOAPPart
也是一个 DOM Level 2
Document
,它同样可以由使用 DOM 的应用程序、工具和库来操纵(有关更多信息,请参阅 http://www.w3.org/DOM/)。务必注意,虽然可以使用 DOM API 将普通的 DOM 节点添加到 SAAJ 树,但在检查或操纵树时,SAAJ API 仍需要返回 SAAJ 类型。要实现这一点,应允许 SAAJ API(特别是
SOAPElement.getChildElements()
)用所需类型的等效对象正常地替换相对于 SAAJ 需求来说未正确类型化的对象。这些替换一定不能导致树的逻辑结构发生更改,所以从 DOM API 的角度来看,树将保持不变。但是,树的物理混合将更改,从而对被替换的节点的引用将引用不再是树的一部分的节点。如果不需要,则不允许 SAAJ API 进行这些替换,因此替换对象以后就不会被 SAAJ API 的后续调用正常地替换。
这实际上意味着,在使用 DOM API 操纵树之后,开始使用 SAAJ API 来操纵树的应用程序必须假定该树已转换为一个纯 SAAJ 树,并且使用 DOM API 获取的对树中对象的任何引用不再有效。从 SAAJ API 切换到 DOM API 不会导致无效引用,独占地使用 SAAJ API 也不会导致无效引用。只有从在特定 SAAJ 树上使用 DOM API 切换到使用 SAAJ API 时,才有导致无效引用的风险。