- 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
对象的方法。- 从以下版本开始:
- 1.6
-
-
构造方法摘要
构造方法 Constructor 描述 SOAPFactory()
-
方法摘要
所有方法 静态方法 接口方法 抽象方法 具体的方法 Modifier and Type 方法 描述 abstract Detail
createDetail()
创建一个新的Detail
对象,作为DetailEntry
对象的容器。abstract SOAPElement
createElement(String localName)
创建使用给定的本地名称初始化的SOAPElement
对象。abstract SOAPElement
createElement(String localName, String prefix, String uri)
使用给定的本地名称,前缀和uri创建一个新的SOAPElement
对象。SOAPElement
createElement(QName qname)
创建SOAPElement
给定初始化的对象QName
对象。abstract SOAPElement
createElement(Name name)
创建使用给定的SOAPElement
对象初始化的Name
对象。SOAPElement
createElement(Element domElement)
从现有的DOMElement
创建一个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)的一个实例。static SOAPFactory
newInstance(String protocol)
创建一个新的SOAPFactory
对象,该对象是指定实现的实例,此方法使用SAAJMetaFactory来定位实现类并创建SOAPFactory实例。
-
-
-
方法详细信息
-
createElement
public SOAPElement createElement(Element domElement) throws SOAPException
从现有的DOMElement
创建一个SOAPElement
对象。 如果作为参数传入的DOMElement
已经是一个SOAPElement
那么这个方法必须不经修改地返回它,而无需任何进一步的工作。 否则,将创建一个新的SOAPElement
,并深入复制domElement
参数。 返回值的具体类型将取决于domElement
参数的名称。 如果根据domElement
的树的任何部分违反SOAP规则,将抛出一个SOAPException
。- 参数
-
domElement
- - 要复制的Element
。 - 结果
-
新
SOAPElement
是副本domElement
。 - 异常
-
SOAPException
- 如果在创建SOAPElement
对象时出错 - 从以下版本开始:
- 1.6,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
对象时出错 - 从以下版本开始:
- 1.6,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 - 结果
-
创建的新的
SOAPElement
对象 - 异常
-
SOAPException
- 如果在创建SOAPElement
对象时出错
-
createDetail
public abstract Detail createDetail() throws SOAPException
创建一个新的Detail
对象,作为DetailEntry
对象的容器。这种工厂方法创建
Detail
对象,用于在不实用的情况下使用SOAPFault
抽象。- 结果
-
一个
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
- 故障的FaultCode - 结果
-
一个
SOAPFault
对象 - 异常
-
SOAPException
- 如果存在SOAP错误 - 从以下版本开始:
- 1.6,SAAJ 1.3
-
createFault
public abstract SOAPFault createFault() throws SOAPException
创建一个新的默认值SOAPFault
对象- 结果
-
一个
SOAPFault
对象 - 异常
-
SOAPException
- 如果存在SOAP错误 - 从以下版本开始:
- 1.6,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
- 一个String
给出命名空间的URI - 结果
-
用给定的本地名称,命名空间前缀和命名空间URI初始化的一个
Name
对象 - 异常
-
SOAPException
- 如果存在SOAP错误
-
createName
public abstract Name createName(String localName) throws SOAPException
创建使用给定的本地名称初始化的新的Name
对象。这种工厂方法创建
Name
对象,用于在使用SOAPEnvelope
抽象时不实际的SOAPEnvelope
。- 参数
-
localName
- 一个String
给出本地名称 - 结果
-
一个
Name
对象使用给定的本地名称初始化 - 异常
-
SOAPException
- 如果存在SOAP错误
-
newInstance
public static SOAPFactory newInstance() throws SOAPException
创建一个新的SOAPFactory
对象,该对象是默认实现(SOAP 1.1)的一个实例。 此方法使用javax.xml.soap
中指定的查找过程来定位并加载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
有错误 - 从以下版本开始:
- 1.6,SAAJ 1.3
- 另请参见:
-
SAAJMetaFactory
-
-