Package javax.xml.soap

提供用于创建和生成消息的接口。

See: 描述

接口摘要

接口	描述
Detail	一个 DetailEntry对象的容器。
DetailEntry	一 Detail对象的内容，一 SOAPFault对象给出细节。
Name	一个XML名称的表示。
Node	在XML文档中的节点（元素）的表示形式。
SOAPBody	表示在一个肥皂消息中的皂体元素的内容的对象。
SOAPBodyElement	一个 SOAPBodyElement对象代表一个 SOAPBody对象的内容。
SOAPConstants	有关的“协议”的常量的定义。
SOAPElement	表示允许但不由肥皂规范指定的元素的一个对象的对象。
SOAPEnvelope	为soapheader和一 SOAPPart配糖体部分的容器对象。
SOAPFault	在包含错误和/或状态信息的 SOAPBody对象元素。
SOAPFaultElement	在 SOAPFault对象表示的内容。
SOAPHeader	一个肥皂头元素的表示。
SOAPHeaderElement	表示肥皂信封的肥皂头部分的内容的一个对象。
Text	一个节点的值为文本的表示形式。

类摘要

类	描述
AttachmentPart	一个连接到 SOAPMessage对象。
MessageFactory	一个用于创建对象的工厂 SOAPMessage。
MimeHeader	一个对象存储一个MIME标头名称及其价值。
MimeHeaders	一个 MimeHeader对象的容器，它代表在一个消息的MIME部分MIME标头。
SAAJMetaFactory	接入点的实现类中定义的API用于工厂。
SAAJResult	作为一个JAXP转换或JAXB编组结果架，在一个用于树的形式。
SOAPConnection	客户端可以直接向远程方发送消息的点对点连接（例如，由一个链接表示）。
SOAPConnectionFactory	一个用于创建对象的工厂 SOAPConnection。
SOAPElementFactory	Deprecated 为创造soapelements使用javax.xml.soap.SOAPFactory。
SOAPFactory	SOAPFactory是一个用于创建在SOAP XML树存在的各种对象的工厂。
SOAPMessage	所有的消息的根类。
SOAPPart	对一个对象的特定部分 SOAPMessage肥皂容器。

异常摘要

异常	描述
SOAPException	发生了一个异常的信号，即出现了一个异常。

Package javax.xml.soap Description

提供用于创建和生成消息的接口。这个包是定义在附件JavaTM SOAP API（SAAJ）1.3规范。

在javax.xml.soap包的API允许您做以下：

• 创建一个点对点连接到指定的端点
• 创建一个肥皂消息
• 创建一个XML片段
• 向一个肥皂消息的头添加内容
• 向一个肥皂消息的身体添加内容
• 创建附件部分，并向他们添加内容
• 访问/添加/修改一个肥皂消息的部分
• 创建/添加/修改肥皂故障信息
• 从一个肥皂消息中提取内容
• 发送一个请求响应消息

此外在 javax.xml.soap封装的API扩展他们的同行在 org.w3c.dom包。这意味着 SOAPMessage的 SOAPPart也是一个DOM级别2 Document，可操纵等应用程序，工具和库，使用DOM（更多信息请看http://www.w3.org/dom/）。值得注意的是，虽然它可能是API使用DOM到saaj添加普通DOM节点树，SAAJ API仍然要求返回类型时，用于检查或操纵的树。为了完成这个SAAJ API（具体 SOAPElement.getChildElements()）可以默默地替换错误类型相对SAAJ要求所需类型的等效对象。这些替代品不能引起树的逻辑结构发生变化，所以从DOM树将保持不变的角度。然而，树的物理组成将发生改变，因此被替换的节点将引用不再是树的一部分的节点。SAAJ API是不允许搞这些替换如果他们不需要这样的替代对象将不会被默默的将来取代SAAJ API。

这意味着什么，实际上是一个应用程序，开始在树上API使用SAAJ后使用DOM操作必须假设树已被翻译成所有SAAJ树和任何对象的引用在树上得到使用DOM API不再有效。从用于切换到DOM API是不允许导致无效的引用也不是完全使用SAAJ API。只有开关使用DOM树的特定使用saaj api用于导致无效的风险references.