Skip navigation links
Java™ Platform
Standard Ed. 8

Package javax.xml.soap

提供用于创建和构建SOAP消息的API。

See: 描述

Package javax.xml.soap Description

提供用于创建和构建SOAP消息的API。 此包在SOAP with Java TM (SAAJ)1.3规范的附件API中定义。

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

另外, javax.xml.soap包中的API扩展了其对应的org.w3c.dom包。 这意味着SOAPPartSOAPMessage也是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不允许进行这些替换,因此替换对象永远不会被以后的SAAJ API调用替代。

实际上这意味着在使用DOM API处理树之后,开始使用SAAJ API的应用程序必须假定该树已被转换为所有SAAJ树,并且对已获得的树中的对象的任何引用使用DOM API不再有效。 从SAAJ API切换到DOM API不允许导致无效引用,也不会专门使用SAAJ API。 它只是在特定的SAAJ树上使用DOM API切换到使用导致无效引用风险的SAAJ API。

Skip navigation links
Java™ Platform
Standard Ed. 8