SOAPFactory (Java EE 5 SDK)

Java

previous page next page
概述  软件包   类  树  已过时  索引  帮助 
Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.
 上一个类   下一个类 框架    无框架    
摘要: 嵌套 | 字段 | 构造器 | 方法 详细信息: 字段 | 构造器 | 方法

javax.xml.soap Class SOAPFactory

java.lang.Object
  extended by javax.xml.soap.SOAPFactory

public abstract class SOAPFactory
extends Object

SOAPFactory is a factory for creating various objects that exist in the SOAP XML tree. SOAPFactory can be used to create XML fragments that will eventually end up in the SOAP part. These fragments can be inserted as children of the SOAPHeaderElement or SOAPBodyElement or SOAPEnvelope or other SOAPElement objects. SOAPFactory also has methods to create javax.xml.soap.Detail objects as well as java.xml.soap.Name objects.

构造器摘要
SOAPFactory()
           
 
方法摘要
abstract  Detail createDetail()
          Creates a new Detail object which serves as a container for DetailEntry objects.
 SOAPElement createElement(Element domElement)
          Creates a SOAPElement object from an existing DOM Element.
abstract  SOAPElement createElement(Name name)
          Creates a SOAPElement object initialized with the given Name object.
 SOAPElement createElement(QName qname)
          Creates a SOAPElement object initialized with the given QName object.
abstract  SOAPElement createElement(String localName)
          Creates a SOAPElement object initialized with the given local name.
abstract  SOAPElement createElement(String localName, String prefix, String uri)
          Creates a new SOAPElement object with the given local name, prefix and uri.
abstract  SOAPFault createFault()
          Creates a new default SOAPFault object
abstract  SOAPFault createFault(String reasonText, QName faultCode)
          Creates a new SOAPFault object initialized with the given reasonText and faultCode
abstract  Name createName(String localName)
          Creates a new Name object initialized with the given local name.
abstract  Name createName(String localName, String prefix, String uri)
          Creates a new Name object initialized with the given local name, namespace prefix, and namespace URI.
static SOAPFactory newInstance()
          Creates a new SOAPFactory object that is an instance of the default implementation (SOAP 1.1), This method uses the following ordered lookup procedure to determine the SOAPFactory implementation class to load: Use the javax.xml.soap.SOAPFactory system property.
static SOAPFactory newInstance(String protocol)
          Creates a new SOAPFactory object that is an instance of the specified implementation, this method uses the SAAJMetaFactory to locate the implementation class and create the SOAPFactory instance.
 
类方法继承 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
Creates a SOAPElement object from an existing DOM Element. If the DOM Element that is passed in as an argument is already a SOAPElement then this method must return it unmodified without any further work. Otherwise, a new SOAPElement is created and a deep copy is made of the domElement argument. The concrete type of the return value will depend on the name of the domElement argument. If any part of the tree rooted in domElement violates SOAP rules, a SOAPException will be thrown.

参数:
domElement - - the Element to be copied.
返回:
a new SOAPElement that is a copy of domElement.
抛出异常:
SOAPException - if there is an error in creating the SOAPElement object
从以下版本开始:
SAAJ 1.3

createElement

public abstract SOAPElement createElement(Name name)
                                   throws SOAPException
Creates a SOAPElement object initialized with the given Name object. The concrete type of the return value will depend on the name given to the new SOAPElement. For instance, a new SOAPElement with the name "{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a SOAPEnvelope that supports SOAP 1.2 behavior to be created.

参数:
name - a Name object with the XML name for the new element
返回:
the new SOAPElement object that was created
抛出异常:
SOAPException - if there is an error in creating the SOAPElement object
另请参见:
createElement(javax.xml.namespace.QName)

createElement

public SOAPElement createElement(QName qname)
                          throws SOAPException
Creates a SOAPElement object initialized with the given QName object. The concrete type of the return value will depend on the name given to the new SOAPElement. For instance, a new SOAPElement with the name "{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a SOAPEnvelope that supports SOAP 1.2 behavior to be created.

参数:
qname - a QName object with the XML name for the new element
返回:
the new SOAPElement object that was created
抛出异常:
SOAPException - if there is an error in creating the SOAPElement object
从以下版本开始:
SAAJ 1.3
另请参见:
createElement(Name)

createElement

public abstract SOAPElement createElement(String localName)
                                   throws SOAPException
Creates a SOAPElement object initialized with the given local name.

参数:
localName - a String giving the local name for the new element
返回:
the new SOAPElement object that was created
抛出异常:
SOAPException - if there is an error in creating the SOAPElement object

createElement

public abstract SOAPElement createElement(String localName,
                                          String prefix,
                                          String uri)
                                   throws SOAPException
Creates a new SOAPElement object with the given local name, prefix and uri. The concrete type of the return value will depend on the name given to the new SOAPElement. For instance, a new SOAPElement with the name "{http://www.w3.org/2003/05/soap-envelope}Envelope" would cause a SOAPEnvelope that supports SOAP 1.2 behavior to be created.

参数:
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
抛出异常:
SOAPException - if there is an error in creating the SOAPElement object

createDetail

public abstract Detail createDetail()
                             throws SOAPException
Creates a new Detail object which serves as a container for DetailEntry objects.

This factory method creates Detail objects for use in situations where it is not practical to use the SOAPFault abstraction.

返回:
a Detail object
抛出异常:
SOAPException - if there is a SOAP error
UnsupportedOperationException - if the protocol specified for the SOAPFactory was DYNAMIC_SOAP_PROTOCOL

createFault

public abstract SOAPFault createFault(String reasonText,
                                      QName faultCode)
                               throws SOAPException
Creates a new SOAPFault object initialized with the given reasonText and faultCode

参数:
reasonText - the ReasonText/FaultString for the fault
faultCode - the FaultCode for the fault
返回:
a SOAPFault object
抛出异常:
SOAPException - if there is a SOAP error
从以下版本开始:
SAAJ 1.3

createFault

public abstract SOAPFault createFault()
                               throws SOAPException
Creates a new default SOAPFault object

返回:
a SOAPFault object
抛出异常:
SOAPException - if there is a SOAP error
从以下版本开始:
SAAJ 1.3

createName

public abstract Name createName(String localName,
                                String prefix,
                                String uri)
                         throws SOAPException
Creates a new Name object initialized with the given local name, namespace prefix, and namespace URI.

This factory method creates Name objects for use in situations where it is not practical to use the SOAPEnvelope abstraction.

参数:
localName - a String giving the local name
prefix - a String giving the prefix of the namespace
uri - a String giving the URI of the namespace
返回:
a Name object initialized with the given local name, namespace prefix, and namespace URI
抛出异常:
SOAPException - if there is a SOAP error

createName

public abstract Name createName(String localName)
                         throws SOAPException
Creates a new Name object initialized with the given local name.

This factory method creates Name objects for use in situations where it is not practical to use the SOAPEnvelope abstraction.

参数:
localName - a String giving the local name
返回:
a Name object initialized with the given local name
抛出异常:
SOAPException - if there is a SOAP error

newInstance

public static SOAPFactory newInstance()
                               throws SOAPException
Creates a new SOAPFactory object that is an instance of the default implementation (SOAP 1.1), This method uses the following ordered lookup procedure to determine the SOAPFactory implementation class to load:
  • Use the javax.xml.soap.SOAPFactory system property.
  • Use the properties file "lib/jaxm.properties" in the JRE directory. This configuration file is in standard java.util.Properties format and contains the fully qualified name of the implementation class with the key being the system property defined above.
  • Use the Services API (as detailed in the JAR specification), if available, to determine the classname. The Services API will look for a classname in the file META-INF/services/javax.xml.soap.SOAPFactory in jars available to the runtime.
  • Use the SAAJMetaFactory instance to locate the SOAPFactory implementation class.

返回:
a new instance of a SOAPFactory
抛出异常:
SOAPException - if there was an error creating the default SOAPFactory
另请参见:
SAAJMetaFactory

newInstance

public static SOAPFactory newInstance(String protocol)
                               throws SOAPException
Creates a new SOAPFactory object that is an instance of the specified implementation, this method uses the SAAJMetaFactory to locate the implementation class and create the SOAPFactory instance.

参数:
protocol - a string constant representing the protocol of the specified SOAP factory implementation. May be either DYNAMIC_SOAP_PROTOCOL, DEFAULT_SOAP_PROTOCOL (which is the same as) SOAP_1_1_PROTOCOL, or SOAP_1_2_PROTOCOL.
返回:
a new instance of a SOAPFactory
抛出异常:
SOAPException - if there was an error creating the specified SOAPFactory
从以下版本开始:
SAAJ 1.3
另请参见:
SAAJMetaFactory
概述  软件包   类  树  已过时  索引  帮助 
Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.
 上一个类   下一个类 框架    无框架    
摘要: 嵌套 | 字段 | 构造器 | 方法 详细信息: 字段 | 构造器 | 方法
提交错误或意见

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.

previous page start next page