| |||||||||
| 摘要： 嵌套 | 字段 | 构造方法 | 方法 | 详细信息： 字段 | 构造方法 | 方法 | ||||||||
javax.xml.soap
类 SOAPFactory
java.lang.Objectjavax.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 |
| 构造方法详细信息 |
|---|
SOAPFactory
public SOAPFactory()
| 方法详细信息 |
|---|
createElement
public SOAPElement createElement(Element domElement) throws SOAPException
- 根据现有的 DOM
Element创建SOAPElement对象。如果作为参数传入的 DOMElement已经是一个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- 给出新元素本地名称的Stringprefix- 此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