SAAJMetaFactory JDK 1.6)

Description

publicabstract abstract class SAAJMetaFactory

The access point for the implementation classes of the factories defined in the SAAJ API.

The access point for the implementation classes of the factories defined in the SAAJ API. All of the newInstance methods defined on factories in SAAJ 1.3 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. There are no public methods on this class.

See also:

Methods

Hide/Show inherited methods

pack-privatestaticsynchronized SAAJMetaFactory getInstance () throws SOAPException

Creates a new instance of a concrete SAAJMetaFactory object.

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 following ordered lookup procedure to determine the SAAJMetaFactory implementation class to load:

Use the javax.xml.soap.MetaFactory 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.MetaFactory in jars available to the runtime.
Default to com.sun.xml.internal.messaging.saaj.soap.SAAJMetaFactoryImpl.

Returns: a concrete SAAJMetaFactory object
Throws:
- SOAPException - if there is an error in creating the SAAJMetaFactory

protectedabstract MessageFactory newMessageFactory (String protocol) throws SOAPException

Creates a MessageFactory object for the given String protocol.

Creates a MessageFactory object for
the given String protocol.
Parameters:
- protocol - a String indicating the protocol
Throws:
- 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,

protectedabstract SOAPFactory newSOAPFactory (String protocol) throws SOAPException

Creates a SOAPFactory object for the given String protocol.

Creates a SOAPFactory object for
the given String protocol.
Parameters:
- protocol - a String indicating the protocol
Throws:
- 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,