SOAPFactory (Java Platform SE 8 )

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

```
public abstract class SOAPFactory
extends Object
```
SOAPFactory是一个用于创建在SOAP XML树存在的各种对象的工厂。 SOAPFactory可以用来创建XML片段，最终将肥皂的一部分。这些片段可以插入的 SOAPHeaderElement或 SOAPBodyElement或 SOAPEnvelope或其他 SOAPElement对象儿童。 SOAPFactory也有方法来创建 javax.xml.soap.Detail对象以及 java.xml.soap.Name对象。

构造方法摘要

构造方法

Constructor and Description

SOAPFactory()

构造方法
Constructor and Description
`SOAPFactory()`

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract Detail`	`createDetail()` 创建一个新的 `Detail`对象作为一个 `DetailEntry`对象的容器。
`SOAPElement`	`createElement(Element domElement)` 创建从现有DOM `Element`一 `SOAPElement`对象。
`abstract SOAPElement`	`createElement(Name name)` 创建一个 `SOAPElement`对象与给定的 `Name`对象初始化。
`SOAPElement`	`createElement(QName qname)` 创建一个 `SOAPElement`对象与给定的 `QName`对象初始化。
`abstract SOAPElement`	`createElement(String localName)` 创建一个 `SOAPElement`对象与给定的本地名称初始化。
`abstract SOAPElement`	`createElement(String localName, String prefix, String uri)` 创建一个新的 `SOAPElement`对象与给定的本地名称前缀和URI。
`abstract SOAPFault`	`createFault()` 创建一个新的默认 `SOAPFault`对象
`abstract SOAPFault`	`createFault(String reasonText, QName faultCode)` 创建一个新的 `SOAPFault`对象与给定的 `reasonText`和 `faultCode`初始化
`abstract Name`	`createName(String localName)` 创建一个新的 `Name`对象与给定的本地名称初始化。
`abstract Name`	`createName(String localName, String prefix, String uri)` 创建一个新的 `Name`对象与给定的本地名称和命名空间URI命名空间前缀初始化。
`static SOAPFactory`	`newInstance()` 创建一个新的 `SOAPFactory`对象是默认实现的实例（肥皂1.1），这种方法使用以下命令查找程序来确定soapfactory实现类负荷：用javax.xml.soap.soapfactory系统性能。
`static SOAPFactory`	`newInstance(String protocol)` 创建一个新的 `SOAPFactory`对象是指定的一个实施例中，该方法使用saajmetafactory定位的实现类和创建soapfactory实例。

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - SOAPFactory
```
public SOAPFactory()
```
- 方法详细信息
  - createElement
```
public SOAPElement createElement(Element domElement)
                          throws SOAPException
```
    创建从现有DOM Element一 SOAPElement对象。如果DOM Element，作为一个参数传递已经是一个 SOAPElement那么这个方法必须返回它的修改没有任何进一步的工作。否则，一个新的 SOAPElement创造和深复制是对 domElement论点。返回值的类型将取决于具体的 domElement参数的名称。如果这棵树扎根在 domElement违反规则的任何部分，肥皂，一 SOAPException将抛出。
    
    参数
    
    domElement -的 Element被复制。
    
    结果
    
    一个新的 SOAPElement是一份 domElement。
    
    异常
    
    SOAPException -如果在创建 SOAPElement对象错误
    
    从以下版本开始：
    
    SAAJ 1.3
  - createElement
```
public abstract SOAPElement createElement(Name name)
                                   throws SOAPException
```
    创建一个 SOAPElement对象与给定的 Name对象初始化。返回值的具体类型将取决于给新 SOAPElement名称。例如，一个新的名称“{ SOAPElement HTTP：/ /两。org / 2003 / 05 / SOAP信封}信封”将导致一个支持SOAP 1.2行为产生的 SOAPEnvelope。
    
    参数
    
    name -使用XML名称 Name对象为新的元素
    
    结果
    
    新 SOAPElement创建对象
    
    异常
    
    SOAPException -如果在创建 SOAPElement对象错误
    
    另请参见：
    
    createElement(javax.xml.namespace.QName)
  - createElement
```
public SOAPElement createElement(QName qname)
                          throws SOAPException
```
    创建一个 SOAPElement对象与给定的 QName对象初始化。返回值的具体类型将取决于给新 SOAPElement名称。例如，一个新的名称“{ SOAPElement HTTP：/ /两。org / 2003 / 05 / SOAP信封}信封”将导致一个支持SOAP 1.2行为产生的 SOAPEnvelope。
    
    参数
    
    qname - QName对象与XML名称为新的元素
    
    结果
    
    新 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
```
    创建一个新的 SOAPElement对象与给定的本地名称前缀和URI。返回值的具体类型将取决于给新 SOAPElement名称。例如，一个新的名称“{ SOAPElement HTTP：/ /两。org / 2003 / 05 / SOAP信封}信封”将导致一个支持SOAP 1.2行为产生的 SOAPEnvelope。
    
    参数
    
    localName - String给当地的名称为新的元素
    
    prefix -这 SOAPElement前缀
    
    uri - String给URI命名空间的元素属于
    
    异常
    
    SOAPException -如果在创建 SOAPElement对象错误
  - createDetail
```
public abstract Detail createDetail()
                             throws SOAPException
```
    创建一个新的 Detail对象作为一个 DetailEntry对象的容器。
    这个工厂方法创建用于在不使用SOAPFault抽象对象的实际情况Detail。
    
    结果
    
    一个 Detail对象
    
    异常
    
    SOAPException -如果有一个SOAP错误
    
    UnsupportedOperationException如果为soapfactory指定的协议 DYNAMIC_SOAP_PROTOCOL
  - createFault
```
public abstract SOAPFault createFault(String reasonText,
                                      QName faultCode)
                               throws SOAPException
```
    创建一个新的 SOAPFault对象与给定的 reasonText和 faultCode初始化
    
    参数
    
    reasonText - reasontext / faultstring的故障
    
    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
```
    创建一个新的 Name对象与给定的本地名称和命名空间URI命名空间前缀初始化。
    这个工厂方法创建用于在不使用SOAPEnvelope抽象对象的实际情况Name。
    
    参数
    
    localName - String给本地名称
    
    prefix - String给命名空间的前缀
    
    uri - String给命名空间的URI
    
    结果
    
    一个 Name对象初始化与给定的本地名称和命名空间URI命名空间前缀，
    
    异常
    
    SOAPException -如果有一个SOAP错误
  - createName
```
public abstract Name createName(String localName)
                         throws SOAPException
```
    创建一个新的 Name对象与给定的本地名称初始化。
    这个工厂方法创建用于在不使用SOAPEnvelope抽象对象的实际情况Name。
    
    参数
    
    localName - String给本地名称
    
    结果
    
    一个 Name对象初始化与给定的本地名称
    
    异常
    
    SOAPException -如果有一个SOAP错误
  - newInstance
```
public static SOAPFactory newInstance()
                               throws SOAPException
```
    创建一个新的 SOAPFactory对象是默认实现的实例（肥皂1.1），这种方法使用以下命令查找程序来确定soapfactory实现类负荷：
    - 使用javax.xml.soap.soapfactory系统性能。
    - 使用属性文件的“库/ JAXM。属性”在JRE目录。这个配置文件是java.util.properties格式标准，包含实现类的完全限定名的关键是上面定义的系统性能。
    - 使用服务的API（如罐中详细说明），如果有，确定类名。服务API将在文件META-INF /服务/ javax.xml.soap.soapfactory提供运行时罐类名。
    - 使用saajmetafactory实例定位soapfactory实现类。
    结果
    
    一个 SOAPFactory新实例
    
    异常
    
    SOAPException如果创建默认的 SOAPFactory出错
    
    另请参见：
    
    SAAJMetaFactory
  - newInstance
```
public static SOAPFactory newInstance(String protocol)
                               throws SOAPException
```
    创建一个新的 SOAPFactory对象是指定的一个实施例中，该方法使用saajmetafactory定位的实现类和创建soapfactory实例。
    
    参数
    
    protocol -一个字符串常量表示指定的肥皂厂实施协议。可能是 DYNAMIC_SOAP_PROTOCOL， DEFAULT_SOAP_PROTOCOL（是一样的） SOAP_1_1_PROTOCOL，或 SOAP_1_2_PROTOCOL。
    
    结果
    
    一个 SOAPFactory新实例
    
    异常
    
    SOAPException如果创建指定的 SOAPFactory出错
    
    从以下版本开始：
    
    SAAJ 1.3
    
    另请参见：
    
    SAAJMetaFactory

Submit a bug or feature
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2014, Oracle and/or its affiliates. All rights reserved.

Class SOAPFactory

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

Constructor Detail

SOAPFactory

方法详细信息

createElement

createElement

createElement

createElement

createElement

createDetail

createFault

createFault

createName

createName

newInstance

newInstance