public abstract class ProviderConnectionFactory {
// Public Constructors
public ProviderConnectionFactory( );
// Public Class Methods
public static ProviderConnectionFactory newInstance( ) throws JAXMException;
// Public Instance Methods
public abstract ProviderConnection createConnection( ) throws JAXMException;
}
ProviderConnectionFactory is an abstract class
that can be used to create ProviderConnection
objects for the purpose of obtaining a connection to a JAXM provider.
In a container-based environment, a JAXM client uses a JNDI lookup to
obtain a preconfigured ProviderConnectionFactory
that results in the message that it subsequently created being sent
to a JAXM provider chosen by an administrator.
An alternative way to obtain an instance of this class is to call the
static newInstance( ) method. This method locates
a concrete implementation of
ProviderConnectionFactory as follows, stopping
when a suitable class is found:
Looks in the system properties for a property called
javax.xml.messaging.ProviderConnectionFactory. If
this property is defined, its value is assumed to be the class name
of a concrete implementation of
ProviderConnectionFactory.
Looks for the same property in a file called
${JAVA_HOME}/lib/jaxm.properties. If the property
is found, its value is assumed to be the required class name.
Looks for a resource called
META-INF/services/javax.xml.messaging.ProviderConnectionFactory
in the classpath. If such a resource exists, it is opened and a
single line is read from it. If the line is not empty, it is used as
the required class name.
Finally, an implementation-dependent default class is used. In the
case of the reference implementation, this class is called
com.sun.xml.messaging.jaxm.client.remote.ProviderConnectionFactoryImpl.
The createConnection( ) method returns a
ProviderConnection object that allows a client to
communicate with a JAXM provider. The means by which the provider is
located is implementation-dependent. In the case of the reference
implementation, the provider's address is configured
in a file called client.xml, which must be
accessible as a resource in the classpath of the client. For a
description of the content of this file, refer to Chapter 4.
