javax.xml.soap
类 SOAPFactory

java.lang.Object
  javax.xml.soap.SOAPFactory

public abstract class SOAPFactory
extends Object

SOAPFactory 是用来创建存在于 SOAP XML 树中的各种对象的工厂。SOAPFactory 可以用于创建最终成为 SOAP 部分的 XML 片段。这些片段可以作为 SOAPHeaderElement、SOAPBodyElement、SOAPEnvelope 或其他 SOAPElement 对象的子级插入。SOAPFactory 还具有创建 javax.xml.soap.Detail 对象以及 java.xml.soap.Name 对象的方法。

SOAPFactory

public SOAPFactory()

createElement

public SOAPElement createElement(Element domElement)
                          throws SOAPException

根据现有的 DOM Element 创建 SOAPElement 对象。如果作为参数传入的 DOM Element 已经是一个 SOAPElement，那么此方法必须不作任何修改地返回该参数。否则，会创建新的 SOAPElement 并进行此 domElement 参数的深层复制。返回值的具体类型将取决于 domElement 参数的名称。如果以 domElement 为根的树的任何部分违背了 SOAP 规则，则会抛出 SOAPException。

参数：

domElement - 要复制的 Element。

返回：

一个新的 SOAPElement，它是 domElement 的副本。

抛出：

SOAPException - 如果在创建 SOAPElement 对象时存在错误

从以下版本开始：

SAAJ 1.3

createElement

public abstract SOAPElement createElement(Name name)
                                   throws SOAPException

创建使用给定 Name 对象初始化的 SOAPElement 对象。返回值的具体类型将取决于提供给新 SOAPElement 的名称。例如，一个带有名称 "{http://www.w3.org/2003/05/soap-envelope}Envelope" 的新 SOAPElement 会导致创建支持 SOAP 1.2 行为的 SOAPEnvelope。

参数：

name - 带有新元素 XML 名称的 Name 对象

返回：

创建的新 SOAPElement 对象

抛出：

SOAPException - 如果在创建 SOAPElement 对象时出现错误

另请参见：

createElement(javax.xml.namespace.QName)

createElement

public SOAPElement createElement(QName qname)
                          throws SOAPException

创建使用给定 QName 对象初始化的 SOAPElement 对象。返回值的具体类型将取决于提供给新 SOAPElement 的名称。例如，一个带有名称 "{http://www.w3.org/2003/05/soap-envelope}Envelope" 的新 SOAPElement 会导致创建支持 SOAP 1.2 行为的 SOAPEnvelope。

参数：

qname - 带有新元素 XML 名称的 QName 对象

返回：

创建的新 SOAPElement 对象

抛出：

SOAPException - 如果在创建 SOAPElement 对象时出现错误

从以下版本开始：

SAAJ 1.3

另请参见：

createElement(Name)

createElement

public abstract SOAPElement createElement(String localName)
                                   throws SOAPException

创建使用给定本地名称初始化的 SOAPElement 对象。

参数：

localName - 给出新元素本地名称的 String

返回：

创建的新 SOAPElement 对象

抛出：

SOAPException - 如果在创建 SOAPElement 对象时存在错误

createElement

public abstract SOAPElement createElement(String localName,
                                          String prefix,
                                          String uri)
                                   throws SOAPException

使用本地名称、前缀和 URI 创建新的 SOAPElement 对象。返回值的具体类型将取决于提供给新 SOAPElement 的名称。例如，一个带有名称 "{http://www.w3.org/2003/05/soap-envelope}Envelope" 的新 SOAPElement 会导致创建支持 SOAP 1.2 行为的 SOAPEnvelope。

参数：

localName - 给出新元素本地名称的 String

prefix - 此 SOAPElement 的前缀

uri - 给出新元素所属名称空间 URI 的 String

抛出：

SOAPException - 如果在创建 SOAPElement 对象时存在错误

createDetail

public abstract Detail createDetail()
                             throws SOAPException

创建充当 DetailEntry 对象容器的新 Detail 对象。

此工厂方法创建 Detail 对象，用于不可能使用 SOAPFault 抽象的情况。

返回：

一个 Detail 对象

抛出：

SOAPException - 如果存在 SOAP 错误

UnsupportedOperationException - 如果为 SOAPFactory 指定的协议是 DYNAMIC_SOAP_PROTOCOL

createFault

public abstract SOAPFault createFault(String reasonText,
                                      QName faultCode)
                               throws SOAPException

创建使用给定 reasonText 和 faultCode 初始化的新 SOAPFault 对象

参数：

reasonText - 错误的 ReasonText/FaultString

faultCode - 错误的 FaultCode

返回：

一个 SOAPFault 对象

抛出：

SOAPException - 如果存在 SOAP 错误

从以下版本开始：

SAAJ 1.3

createFault

public abstract SOAPFault createFault()
                               throws SOAPException

创建一个新的默认 SOAPFault 对象

返回：

一个 SOAPFault 对象

抛出：

SOAPException - 如果存在 SOAP 错误

从以下版本开始：

SAAJ 1.3

createName

public abstract Name createName(String localName,
                                String prefix,
                                String uri)
                         throws SOAPException

创建使用给定本地名称、名称空间前缀和名称空间 URI 初始化的新 Name 对象。

此工厂方法创建 Name 对象，用于不可能使用 SOAPEnvelope 抽象的情况。

参数：

localName - 给出本地名称的 String

prefix - 给出名称空间前缀的 String

uri - 给出名称空间 URI 的 String

返回：

使用给定本地名称、名称空间前缀和名称空间 URI 初始化的 Name 对象

抛出：

SOAPException - 如果存在 SOAP 错误

createName

public abstract Name createName(String localName)
                         throws SOAPException

创建使用给定本地名称初始化的新 Name 对象。

此工厂方法创建 Name 对象，用于不可能使用 SOAPEnvelope 抽象的情况。

参数：

localName - 给出本地名称的 String

返回：

使用给定本地名称初始化的 Name 对象

抛出：

SOAPException - 如果存在 SOAP 错误

newInstance

public static SOAPFactory newInstance()
                               throws SOAPException

创建新的 SOAPFactory 对象，该对象是默认实现 (SOAP 1.1) 的实例。 此方法使用以下查找过程顺序来确定要加载的 SOAPFactory 实现类：

• 使用 javax.xml.soap.SOAPFactory 系统属性。
• 使用 JRE 文件夹中的属性文件 "lib/jaxm.properties"。此配置文件格式是标准的 java.util.Properties 格式且包含实现类的完全限定名，其中实现类的键是上文定义的系统属性。
• 如果 Services API（在 JAR 规范中进行了详细描述）可用，可以使用它来确定类名称。Services API 将查找在运行时可用的 jar 中 META-INF/services/javax.xml.soap.SOAPFactory 文件中的类名称。
• 使用 SAAJMetaFactory 实例来定位 SOAPFactory 实现类。

返回：

新的 SOAPFactory 实例

抛出：

SOAPException - 如果在创建默认 SOAPFactory 时出现错误

另请参见：

SAAJMetaFactory

newInstance

public static SOAPFactory newInstance(String protocol)
                               throws SOAPException

创建新的 SOAPFactory 对象，该对象是指定实现的实例，此方法使用 SAAJMetaFactory 来定位实现类并创建 SOAPFactory 实例。

参数：

protocol - 字符串常量，表示指定 SOAP 工厂实现的协议。可以是 DYNAMIC_SOAP_PROTOCOL、DEFAULT_SOAP_PROTOCOL（等同于 SOAP_1_1_PROTOCOL）或 SOAP_1_2_PROTOCOL。

返回：

新的 SOAPFactory 实例

抛出：

SOAPException - 如果在创建指定 SOAPFactory 时出现错误

从以下版本开始：

SAAJ 1.3

另请参见：

SAAJMetaFactory

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策。