SOAPFactory (Java Platform SE 8 )

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对象的方法。

构造方法摘要

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

方法摘要

所有方法静态方法接口方法抽象方法具体的方法
Modifier and Type	Method and Description
`abstract Detail`	`createDetail()` 创建一个新的 `Detail`对象，作为 `DetailEntry`对象的 `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)` 使用给定的本地名称，前缀和uri创建一个新的 `SOAPElement`对象。
`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)` 创建使用给定的本地名称，命名空间前缀和命名空间URI初始化的新的 `Name`对象。
`static SOAPFactory`	`newInstance()` 创建一个新的 `SOAPFactory`对象，该对象是默认实现（SOAP 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

- 构造方法详细信息
  - 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
```
    创建一个SOAPElement给定初始化的对象Name对象。返回值的具体类型将取决于给定的新名称SOAPElement的名称。例如，名为“{http://www.w3.org/2003/05/soap-envelope}Envelope”的新的SOAPElement将导致SOAPEnvelope支持SOAP 1.2行为被创建。
    
    参数
    
    name - 具有新元素的XML名称的 Name对象
    
    结果
    
    创建的新的 SOAPElement对象
    
    异常
    
    SOAPException - 创建 SOAPElement对象是否有错误
    
    另请参见：
    
    createElement(javax.xml.namespace.QName)
  - createElement
```
public SOAPElement createElement(QName qname)
                          throws SOAPException
```
    创建一个SOAPElement对象使用给定的QName对象初始化。返回值的具体类型将取决于给定的新名称SOAPElement的名称。例如，名为“{http://www.w3.org/2003/05/soap-envelope}Envelope”的新的SOAPElement将导致SOAPEnvelope支持SOAP 1.2行为被创建。
    
    参数
    
    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将导致SOAPEnvelope支持SOAP 1.2行为被创建。
    
    参数
    
    localName - String给出新元素的本地名称
    
    prefix - 这个 SOAPElement的前缀
    
    uri - 一个 String给出新元素所属的命名空间的URI
    
    异常
    
    SOAPException - 创建 SOAPElement对象是否有错误
  - createDetail
```
public abstract Detail createDetail()
                             throws SOAPException
```
    创建一个新的Detail对象，作为DetailEntry对象的DetailEntry 。
    这种工厂方法创建Detail对象，用于在不实用的情况下使用SOAPFault抽象。
    
    结果
    
    一个 Detail对象
    
    异常
    
    SOAPException - 如果存在SOAP错误
    
    UnsupportedOperationException - 如果为 UnsupportedOperationException指定的协议是 DYNAMIC_SOAP_PROTOCOL
  - createFault
```
public abstract SOAPFault createFault(String reasonText,
                                      QName faultCode)
                               throws SOAPException
```
    创建一个新的 SOAPFault对象，初始化为给定的 reasonText和 faultCode
    
    参数
    
    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
```
    创建一个新的Name对象，使用给定的本地名称，命名空间前缀和命名空间URI进行初始化。
    此工厂方法创建Name在情况下使用对象的地方是不实际的使用SOAPEnvelope抽象。
    
    参数
    
    localName - a String给出本地名称
    
    prefix - 一个 String给出 String的前缀
    
    uri - 一个 String给出 String的URI
    
    结果
    
    一个 Name对象使用给定的本地名称，命名空间前缀和命名空间URI进行初始化
    
    异常
    
    SOAPException - 如果存在SOAP错误
  - createName
```
public abstract Name createName(String localName)
                         throws SOAPException
```
    创建一个新的Name对象，使用给定的本地名称初始化。
    这种工厂方法创建Name对象，用于在不实用的情况下使用SOAPEnvelope抽象。
    
    参数
    
    localName - a 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格式，并包含实现类的完全限定名称，其中键为上面定义的系统属性。
    - 使用服务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

Class SOAPFactory

构造方法摘要

方法摘要

Methods inherited from class java.lang.Object

构造方法详细信息

SOAPFactory

方法详细信息

createElement

createElement

createElement

createElement

createElement

createDetail

createFault

createFault

createName

createName

newInstance

newInstance