SOAPElementFactory (Java EE 5)

java.lang.Object
  javax.xml.soap.SOAPElementFactory

SOAPElementFactory 是最终成为 SOAP 部分的 XML 片段的工厂。这些片段可以作为 SOAPHeader 或 SOAPBody 或 SOAPEnvelope 的子元素插入。

使用此工厂创建的元素没有 SOAP 头文档中所含元素的属性。当插入这些元素时，它们被复制到 XML 文档树。

deprecated	- 使用 javax.xml.soap.SOAPFactory 创建 SOAPElements。
See also	javax.xml.soap.SOAPFactory

英文文档：

public class SOAPElementFactory

extends Object

SOAPElementFactory is a factory for XML fragments that will eventually end up in the SOAP part. These fragments can be inserted as children of the SOAPHeader or SOAPBody or SOAPEnvelope.

Elements created using this factory do not have the properties of an element that lives inside a SOAP header document. These elements are copied into the XML document tree when they are inserted.

See Also:

SOAPFactory

---

Method Summary
SOAPElement	create(Name name)           Deprecated. Use javax.xml.soap.SOAPFactory.createElement(javax.xml.soap.Name) instead
SOAPElement	create(String localName)           Deprecated. Use javax.xml.soap.SOAPFactory.createElement(String localName) instead
SOAPElement	create(String localName, String prefix, String uri)           Deprecated. Use javax.xml.soap.SOAPFactory.createElement(String localName, String prefix, String uri) instead
static SOAPElementFactory	newInstance()           Deprecated. Creates a new instance of SOAPElementFactory.

 

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

 

Method Detail

public SOAPElement create(Name name) throws SOAPException
创建使用给定 Name 对象初始化的 SOAPElement 对象。

name	带有新元素 XML 名称的 Name 对象
return	创建的新 SOAPElement 对象
Throws	SOAPException: 如果在创建 SOAPElement 对象时存在错误
deprecated	使用 javax.xml.soap.SOAPFactory.createElement(javax.xml.soap.Name) 替换
See also	createElement(javax.xml.soap.Name), createElement(javax.xml.namespace.QName)

英文文档：

create

public SOAPElement create(Name name)
                   throws SOAPException

Deprecated. Use javax.xml.soap.SOAPFactory.createElement(javax.xml.soap.Name) instead

Create a SOAPElement object initialized with the given Name object.

Parameters:

name - a Name object with the XML name for the new element

Returns:

the new SOAPElement object that was created

Throws:

SOAPException - if there is an error in creating the SOAPElement object

See Also:

SOAPFactory.createElement(javax.xml.soap.Name), SOAPFactory.createElement(javax.xml.namespace.QName)

---

public SOAPElement create(String localName) throws SOAPException
创建使用给定本地名称初始化的 SOAPElement 对象。

localName	给出新元素本地名称的 String
return	创建的新 SOAPElement 对象
Throws	SOAPException: 如果在创建 SOAPElement 对象时存在错误
deprecated	使用 javax.xml.soap.SOAPFactory.createElement(String localName) 替换
See also	createElement(java.lang.String)

英文文档：

create

public SOAPElement create(String localName)
                   throws SOAPException

Deprecated. Use javax.xml.soap.SOAPFactory.createElement(String localName) instead

Create a SOAPElement object initialized with the given local name.

Parameters:

localName - a String giving the local name for the new element

Returns:

the new SOAPElement object that was created

Throws:

SOAPException - if there is an error in creating the SOAPElement object

See Also:

SOAPFactory.createElement(java.lang.String)

---

public SOAPElement create(String localName, String prefix, String uri) throws SOAPException
使用给定的本地名称、前缀和 URL 创建新的 SOAPElement 对象。

localName	给出新元素本地名称的 String
prefix	此 SOAPElement 的前缀
uri	给出新元素所属命名空间 URI 的 String
Throws	SOAPException: 如果在创建 SOAPElement 对象时存在错误
deprecated	使用 javax.xml.soap.SOAPFactory.createElement(String localName, String prefix, String uri) 替换
See also	createElement(java.lang.String, java.lang.String, java.lang.String)

英文文档：

create

public SOAPElement create(String localName,
                          String prefix,
                          String uri)
                   throws SOAPException

Deprecated. Use javax.xml.soap.SOAPFactory.createElement(String localName, String prefix, String uri) instead

Create a new SOAPElement object with the given local name, prefix and uri.

Parameters:

localName - a String giving the local name for the new element

prefix - the prefix for this SOAPElement

uri - a String giving the URI of the namespace to which the new element belongs

Throws:

SOAPException - if there is an error in creating the SOAPElement object

See Also:

SOAPFactory.createElement(java.lang.String, java.lang.String, java.lang.String)

---

public static SOAPElementFactory newInstance() throws SOAPException
创建新的 SOAPElementFactory 实例。

return	新的 SOAPElementFactory 实例
Throws	SOAPException: 如果在创建默认 SOAPElementFactory 时出现错误

英文文档：

newInstance

public static SOAPElementFactory newInstance()
                                      throws SOAPException

Deprecated. 

Creates a new instance of SOAPElementFactory.

Returns:

a new instance of a SOAPElementFactory

Throws:

SOAPException - if there was an error creating the default SOAPElementFactory

---

Overview  Package   Class  Tree  Deprecated  Index  Help
PREV CLASS   NEXT CLASS	FRAMES    NO FRAMES
SUMMARY: NESTED | FIELD | CONSTR | METHOD	DETAIL: FIELD | CONSTR | METHOD

---

Submit a bug or feature

Copyright 2007 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.