Java Web Services in a Nutshell

Name

ProviderConnectionFactory

Synopsis

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:

1. 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.

2. 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.

3. Looks for a resource called META-INF/services/javax.xml.messaging.ProviderConnectionFactory in the classpath. If such a resource exists, it is ...