SOAPFactory

目录搜索

文字

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

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()`

方法摘要
`abstract Detail`	`createDetail()` 创建充当 `DetailEntry` 对象容器的新 `Detail` 对象。
`SOAPElement`	`createElement(Element domElement)` 根据现有的 DOM `Element` 创建 `SOAPElement` 对象。
`abstract SOAPElement`	`createElement(Name name)` 创建使用给定 `Name` 对象初始化的 `SOAPElement` 对象。
`SOAPElement`	`createElement(QName qname)` 创建使用给定 `QName` 对象初始化的 `SOAPElement` 对象。
`abstract SOAPElement`	`createElement(String localName)` 创建使用给定本地名称初始化的 `SOAPElement` 对象。
`abstract SOAPElement`	`createElement(String localName, String prefix, String uri)` 使用本地名称、前缀和 URI 创建新的 `SOAPElement` 对象。
`abstract SOAPFault`	`createFault()` 创建一个新的默认 `SOAPFault` 对象
`abstract SOAPFault`	`createFault(String reasonText, QName faultCode)` 创建使用给定 `reasonText` 和 `faultCode` 初始化的新 `SOAPFault` 对象
`abstract Name`	`createName(String localName)` 创建使用给定本地名称初始化的新 `Name` 对象。
`abstract Name`	`createName(String localName, String prefix, String uri)` 创建使用给定本地名称、名称空间前缀和名称空间 URI 初始化的新 `Name` 对象。
`static SOAPFactory`	`newInstance()` 创建新的 `SOAPFactory` 对象，该对象是默认实现 (SOAP 1.1) 的实例。
`static SOAPFactory`	`newInstance(String protocol)` 创建新的 `SOAPFactory` 对象，该对象是指定实现的实例，此方法使用 SAAJMetaFactory 来定位实现类并创建 SOAPFactory 实例。

从类 java.lang.Object 继承的方法
`clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait`

构造方法详细信息

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

概述

软件包

类

使用

树

已过时

索引

帮助

Java^TM 2 Platform
Standard Ed. 6

上一个类 下一个类

框架 无框架

摘要：嵌套 | 字段 | 构造方法 | 方法

详细信息：字段 | 构造方法 | 方法

提交错误或意见
有关更多的 API 参考资料和开发人员文档，请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述，以及总体概述、术语定义、使用技巧和工作代码示例。

javax.xml.soap 类 SOAPFactory

SOAPFactory

createElement

createElement

createElement

createElement

createElement

createDetail

createFault

createFault

createName

createName

newInstance

newInstance

javax.xml.soap
类 SOAPFactory