javax.resource.cci
Interface ConnectionFactory

All Superinterfaces:

javax.naming.Referenceable, Referenceable (src) , java.io.Serializable

All Known Implementing Classes:

TestConnectionFactory (src)

public interface ConnectionFactory

extends java.io.Serializable, Referenceable (src)

The ConnectionFactory provides an interface for getting a Connection from the Resource adapter. The application retrieves a reference to the ConnectionFactory through a JNDI lookup. ConnectionFactory extends java.io.Serializable and javax.resource.Referenceable in order to support JNDI lookup.

getConnection

public Connection (src)  getConnection()
                         throws ResourceException (src) 

Gets a connection from the resource adapter. When using this method the client does not pass any security information, and wants the container to manage sign-on. This is called container managed sign-on.

Throws:

ResourceException (src)

getConnection

public Connection (src)  getConnection(ConnectionSpec (src)  properties)
                         throws ResourceException (src) 

Gets a connection from the resource adapter. When using this method the client passes in the security information. This is called component managed sign-on.

Throws:

ResourceException (src)

getRecordFactory

public RecordFactory (src)  getRecordFactory()
                               throws ResourceException (src) 

Gets a RecordFactory instance for use in creating Record objects.

Throws:

ResourceException (src)

getMetaData

public ResourceAdapterMetaData (src)  getMetaData()
                                    throws ResourceException (src) 

Gets metadata for the resource adapter. This call does not require an active connection.

Throws:

ResourceException (src)