public abstract class SAAJMetaFactory
extends java.lang.Object
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:
jakarta.xml.soap.SAAJMetaFactory
exists then its value is assumed
to be the fully qualified name of the implementation class. This phase of the look up enables per-JVM
override of the SAAJ implementation.
jakarta.xml.soap.MetaFactory
exists then its value is assumed
to be the fully qualified name of the implementation class. This property, defined by previous specifications
(up to 1.3), is still supported, but it is strongly recommended to migrate to new property
jakarta.xml.soap.SAAJMetaFactory
.
Properties
format
and typically located in the conf
directory of the Java installation. It contains the fully qualified
name of the implementation class with key jakarta.xml.soap.SAAJMetaFactory
. If no such property is defined,
again, property with key jakarta.xml.soap.MetaFactory
is used. It is strongly recommended to migrate to
new property jakarta.xml.soap.SAAJMetaFactory
.
ServiceLoader
class,
to attempt to locate and load an implementation of the service using the default loading mechanism.
There are no public methods on this class.
Modifier | Constructor and Description |
---|---|
protected |
SAAJMetaFactory() |
Modifier and Type | Method and Description |
---|---|
protected abstract MessageFactory |
newMessageFactory(java.lang.String protocol)
Creates a
MessageFactory object for
the given String protocol. |
protected abstract SOAPFactory |
newSOAPFactory(java.lang.String protocol)
Creates a
SOAPFactory object for
the given String protocol. |
protected abstract MessageFactory newMessageFactory(java.lang.String protocol) throws SOAPException
MessageFactory
object for
the given String
protocol.protocol
- a String
indicating the protocolMessageFactory
, not nullSOAPException
- if there is an error in creating the
MessageFactorySOAPConstants.SOAP_1_1_PROTOCOL
,
SOAPConstants.SOAP_1_2_PROTOCOL
,
SOAPConstants.DYNAMIC_SOAP_PROTOCOL
protected abstract SOAPFactory newSOAPFactory(java.lang.String protocol) throws SOAPException
SOAPFactory
object for
the given String
protocol.protocol
- a String
indicating the protocolSOAPFactory
, not nullSOAPException
- if there is an error in creating the
SOAPFactorySOAPConstants.SOAP_1_1_PROTOCOL
,
SOAPConstants.SOAP_1_2_PROTOCOL
,
SOAPConstants.DYNAMIC_SOAP_PROTOCOL