com.ibm.j2ca.base
Class WBIConnectionFactory

java.lang.Object
  extended bycom.ibm.j2ca.base.WBIConnectionFactory
All Implemented Interfaces:
javax.resource.cci.ConnectionFactory, javax.naming.Referenceable, javax.resource.Referenceable, java.io.Serializable

public abstract class WBIConnectionFactory
extends java.lang.Object
implements javax.resource.cci.ConnectionFactory, javax.resource.Referenceable, java.io.Serializable

A ConnectionFactory enables a client to request handles to the underlying EIS connection.

See Also:
Serialized Form

Constructor Summary
WBIConnectionFactory(javax.resource.spi.ConnectionManager connMgr, WBIManagedConnectionFactory mcf)
           
 
Method Summary
 javax.resource.cci.Connection getConnection()
          Returns a new connection handle to the underlying EIS.
 javax.resource.cci.Connection getConnection(javax.resource.cci.ConnectionSpec connectionSpec)
          Returns a new connection handle to the underlying EIS; this handle will match the connection properties specified in connectionSpec
 LogUtils getLogUtils()
           
 javax.resource.spi.ManagedConnectionFactory getManagedConnectionFactory()
          Returns the underlying managed connection factory associated with this factory.
 javax.resource.cci.ResourceAdapterMetaData getMetaData()
          Returns metadata about the capabilities and version of the resource adapter.
 javax.resource.cci.RecordFactory getRecordFactory()
          Not supported.
 javax.naming.Reference getReference()
          Part of support for JNDI lookup.
protected  void setLogUtils(LogUtils utils)
           
 void setReference(javax.naming.Reference reference)
          Part of support for JNDI lookup.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

WBIConnectionFactory

public WBIConnectionFactory(javax.resource.spi.ConnectionManager connMgr,
                            WBIManagedConnectionFactory mcf)
Method Detail

getConnection

public javax.resource.cci.Connection getConnection()
                                            throws javax.resource.ResourceException
Returns a new connection handle to the underlying EIS.

Specified by:
getConnection in interface javax.resource.cci.ConnectionFactory
Returns:
a WBIConnection instance
Throws:
javax.resource.ResourceException

getConnection

public javax.resource.cci.Connection getConnection(javax.resource.cci.ConnectionSpec connectionSpec)
                                            throws javax.resource.ResourceException
Returns a new connection handle to the underlying EIS; this handle will match the connection properties specified in connectionSpec

Specified by:
getConnection in interface javax.resource.cci.ConnectionFactory
Throws:
javax.resource.ResourceException

getRecordFactory

public javax.resource.cci.RecordFactory getRecordFactory()
                                                  throws javax.resource.ResourceException
Not supported. Use AdapterBOUtil.createBusinessObject(java.lang.String, java.lang.String) to create business objects instead.

Specified by:
getRecordFactory in interface javax.resource.cci.ConnectionFactory
Throws:
javax.resource.ResourceException

getMetaData

public javax.resource.cci.ResourceAdapterMetaData getMetaData()
                                                       throws javax.resource.ResourceException
Returns metadata about the capabilities and version of the resource adapter. For information instead about the EIS, see WBIConnection.getMetaData().

Note: this method does not require an active connection to the EIS instance be establsihed.

Specified by:
getMetaData in interface javax.resource.cci.ConnectionFactory
Throws:
javax.resource.ResourceException - if unable to retrieve metadata for the resource adapter

getManagedConnectionFactory

public javax.resource.spi.ManagedConnectionFactory getManagedConnectionFactory()
Returns the underlying managed connection factory associated with this factory.


setReference

public void setReference(javax.naming.Reference reference)
Part of support for JNDI lookup.

Specified by:
setReference in interface javax.resource.Referenceable
See Also:
Referenceable

getReference

public javax.naming.Reference getReference()
Part of support for JNDI lookup.

Specified by:
getReference in interface javax.naming.Referenceable
See Also:
Referenceable

setLogUtils

protected void setLogUtils(LogUtils utils)

getLogUtils

public LogUtils getLogUtils()