Top Description Fields Constructors Methods
javax.xml.soap

public abstract Class SAAJMetaFactory

extends Object
Class Inheritance

The access point for the implementation classes of the factories defined in the SAAJ API. The newInstance methods defined on factories SOAPFactory and MessageFactory in SAAJ 1.4 defer to instances of this class to do the actual object creation. The implementations of newInstance() methods (in SOAPFactory and MessageFactory) that existed in SAAJ 1.2 have been updated to also delegate to the SAAJMetaFactory when the SAAJ 1.2 defined lookup fails to locate the Factory implementation class name.

SAAJMetaFactory is a service provider interface and it uses similar lookup mechanism as other SAAJ factories to get actual instance:

There are no public methods on this class.

Author
SAAJ RI Development Team
Since
1.6, SAAJ 1.3

Field Summary

Modifier and TypeField and Description
private static final String
private static final String

Constructor Summary

AccessConstructor and Description
protected

Method Summary

Modifier and TypeMethod and Description
pack-priv static SAAJMetaFactory

Returns:

a concrete SAAJMetaFactory object
getInstance
()

Creates a new instance of a concrete SAAJMetaFactory object.

protected abstract MessageFactory

Returns:

a MessageFactory, not null
newMessageFactory
(String
a String indicating the protocol
protocol
)

Creates a MessageFactory object for the given String protocol.

protected abstract SOAPFactory

Returns:

a SOAPFactory, not null
newSOAPFactory
(String
a String indicating the protocol
protocol
)

Creates a SOAPFactory object for the given String protocol.

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

DEFAULT_META_FACTORY_CLASSback to summary
private static final String DEFAULT_META_FACTORY_CLASS
META_FACTORY_DEPRECATED_CLASS_PROPERTYback to summary
private static final String META_FACTORY_DEPRECATED_CLASS_PROPERTY

Constructor Detail

SAAJMetaFactoryback to summary
protected SAAJMetaFactory()

Method Detail

getInstanceback to summary
pack-priv static SAAJMetaFactory getInstance() throws SOAPException

Creates a new instance of a concrete SAAJMetaFactory object. The SAAJMetaFactory is an SPI, it pulls the creation of the other factories together into a single place. Changing out the SAAJMetaFactory has the effect of changing out the entire SAAJ implementation. Service providers provide the name of their SAAJMetaFactory implementation. This method uses the lookup procedure specified in javax.xml.soap to locate and load the javax.xml.soap.SAAJMetaFactory class.

Returns:SAAJMetaFactory

a concrete SAAJMetaFactory object

Exceptions
SOAPException:
if there is an error in creating the SAAJMetaFactory
newMessageFactoryback to summary
protected abstract MessageFactory newMessageFactory(String protocol) throws SOAPException

Creates a MessageFactory object for the given String protocol.

Parameters
protocol:String

a String indicating the protocol

Returns:MessageFactory

a MessageFactory, not null

Exceptions
SOAPException:
if there is an error in creating the MessageFactory
See Also
SOAPConstants#SOAP_1_1_PROTOCOL, SOAPConstants#SOAP_1_2_PROTOCOL, SOAPConstants#DYNAMIC_SOAP_PROTOCOL
newSOAPFactoryback to summary
protected abstract SOAPFactory newSOAPFactory(String protocol) throws SOAPException

Creates a SOAPFactory object for the given String protocol.

Parameters
protocol:String

a String indicating the protocol

Returns:SOAPFactory

a SOAPFactory, not null

Exceptions
SOAPException:
if there is an error in creating the SOAPFactory
See Also
SOAPConstants#SOAP_1_1_PROTOCOL, SOAPConstants#SOAP_1_2_PROTOCOL, SOAPConstants#DYNAMIC_SOAP_PROTOCOL