javax.xml.soap

Class SOAPConnectionFactory

java.lang.Object

javax.xml.soap.SOAPConnectionFactory

public abstract class SOAPConnectionFactory
extends java.lang.Object

A factory for creating SOAPConnection objects. Implementation of this class is optional. If SOAPConnectionFactory.newInstance() throws an UnsupportedOperationException then the implementation does not support the SAAJ communication infrastructure. Otherwise SOAPConnection objects can be created by calling createConnection() on the newly created SOAPConnectionFactory object.

Field Summary

Fields

Modifier and Type	Field and Description
private static java.lang.String	DEFAULT_SOAP_CONNECTION_FACTORY

Constructor Summary

Constructors

Constructor and Description
SOAPConnectionFactory()

Method Summary

Modifier and Type	Method and Description
abstract SOAPConnection	createConnection() Create a new SOAPConnection.
static SOAPConnectionFactory	newInstance() Creates an instance of the default SOAPConnectionFactory object.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_SOAP_CONNECTION_FACTORY

private static final java.lang.String DEFAULT_SOAP_CONNECTION_FACTORY

See Also:

Constant Field Values

Constructor Detail

SOAPConnectionFactory

public SOAPConnectionFactory()

Method Detail

newInstance

public static SOAPConnectionFactory newInstance()
                                         throws SOAPException,
                                                java.lang.UnsupportedOperationException

Creates an instance of the default SOAPConnectionFactory object.

Returns:

a new instance of a default SOAPConnectionFactory object

Throws:

SOAPException - if there was an error creating the SOAPConnectionFactory

java.lang.UnsupportedOperationException - if newInstance is not supported.

createConnection

public abstract SOAPConnection createConnection()
                                         throws SOAPException

Create a new SOAPConnection.

Returns:

the new SOAPConnection object.

Throws:

SOAPException - if there was an exception creating the SOAPConnection object.