public abstract class ProviderConnectionFactory
extends java.lang.Object
ProviderConnectionFactory
object can be obtained in two different ways.
ProviderConnectionFactory.newInstance
method to get an instance of the default
ProviderConnectionFactory
object.ProviderConnection
object that connects to the default provider
implementation.
ProviderConnectionFactory pcf = ProviderConnectionFactory.newInstance(); ProviderConnection con = pcf.createConnection();
ProviderConnectionFactory
object that has been registered with a naming service based on
Java Naming and Directory InterfaceTM (JNDI) technology.ProviderConnectionFactory
object is an administered object that was created by a
container (a servlet or Enterprise JavaBeansTM container). The
ProviderConnectionFactory
object was configured in an implementation- specific way, and the connections
it creates will be to the specified messaging provider.
Registering a ProviderConnectionFactory
object with a JNDI naming service associates it with a logical
name. When an application wants to establish a connection with the provider associated with that
ProviderConnectionFactory
object, it does a lookup, providing the logical name. The application can then
use the ProviderConnectionFactory
object that is returned to create a connection to the messaging
provider. The first two lines of the following code fragment use JNDI methods to retrieve a
ProviderConnectionFactory
object. The third line uses the returned object to create a connection to the
JAXM provider that was registered with "ProviderXYZ" as its logical name.
Context ctx = new InitialContext(); ProviderConnectionFactory pcf = (ProviderConnectionFactory) ctx.lookup("ProviderXYZ"); ProviderConnection con = pcf.createConnection();
Constructor and Description |
---|
ProviderConnectionFactory() |
Modifier and Type | Method and Description |
---|---|
abstract ProviderConnection |
createConnection()
Creates a
ProviderConnection object to the messaging provider that is associated with this
ProviderConnectionFactory object. |
static ProviderConnectionFactory |
newInstance()
Creates a default
ProviderConnectionFactory object. |
public abstract ProviderConnection createConnection() throws JAXMException
ProviderConnection
object to the messaging provider that is associated with this
ProviderConnectionFactory
object.ProviderConnection
object that represents a connection to the provider associated with this
ProviderConnectionFactory
objectJAXMException
- if there is an error in creating the connectionpublic static ProviderConnectionFactory newInstance() throws JAXMException
ProviderConnectionFactory
object.ProviderConnectionFactory
JAXMException
- if there was an error creating the default ProviderConnectionFactory
Copyright (c) 2010, 2017 Oracle and/or its affiliates. All rights reserved.