SOAPElementFactory (Java EE 5)

Java EE API

previous page next page

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.xml.soap Class SOAPElementFactory

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

Deprecated. - Use javax.xml.soap.SOAPFactory for creating SOAPElements.

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