javax.xml.soap

接口
异常
提供用于创建和构建 SOAP 消息的 API。

请参见:
          描述

接口摘要
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 异常时,抛出此异常。
 

软件包 javax.xml.soap 的描述

提供用于创建和构建 SOAP 消息的 API。此包在 SOAP with Attachments API for JavaTM (SAAJ) 1.3 规范中进行了定义。

javax.xml.soap 包中的 API 允许执行以下操作:

  • 创建到指定端点的点对点连接
  • 创建 SOAP 消息
  • 创建 XML 片段
  • 将内容添加到 SOAP 消息的头
  • 将内容添加到 SOAP 消息的正文
  • 创建附件部分并向其添加内容
  • 访问/添加/修改 SOAP 消息的一部分
  • 创建/添加/修改 SOAP 错误信息
  • 提取 SOAP 消息的内容
  • 发送 SOAP 请求-响应消息

此外, javax.xml.soap 包中的 API 在 org.w3c.dom 包中扩展了它们的对等项。这意味着 SOAPMessageSOAPPart 也是一个 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 时,才有导致无效引用的风险。