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

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

构造方法详细信息

SOAPFactory

方法详细信息

createElement

createElement

createElement

createElement

createElement

createDetail

createFault

createFault

createName

createName

newInstance

newInstance