org.apache.ojb.broker.accesslayer
Class ConnectionFactoryNotPooledImpl

java.lang.Object
  org.apache.ojb.broker.accesslayer.ConnectionFactoryAbstractImpl
      org.apache.ojb.broker.accesslayer.ConnectionFactoryNotPooledImpl

All Implemented Interfaces:

ConnectionFactory

Direct Known Subclasses:

ConnectionFactoryManagedImpl

public class ConnectionFactoryNotPooledImpl

extends ConnectionFactoryAbstractImpl

Base implementation without connection pooling.

Version:

$Id: ConnectionFactoryNotPooledImpl.java 364736 2005-04-07 13:08:57Z mkalen $

Author:

Armin Waibel

Constructor Summary

ConnectionFactoryNotPooledImpl()

Method Summary

java.sql.Connection	checkOutJdbcConnection(JdbcConnectionDescriptor jcd) Returns a valid JDBC Connection.
void	releaseJdbcConnection(JdbcConnectionDescriptor jcd, java.sql.Connection con) Releases a Connection after use.

Methods inherited from class org.apache.ojb.broker.accesslayer.ConnectionFactoryAbstractImpl

lookupConnection, releaseAllResources, releaseConnection

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

ConnectionFactoryNotPooledImpl

public ConnectionFactoryNotPooledImpl()

Method Detail

checkOutJdbcConnection

public java.sql.Connection checkOutJdbcConnection(JdbcConnectionDescriptor jcd)
                                           throws LookupException

Description copied from class: ConnectionFactoryAbstractImpl

Returns a valid JDBC Connection. Implement this method in concrete subclasses. Concrete implementations using Connection pooling are responsible for any validation and pool removal management.

Note: This method is never called for a jdbc-connection-descriptor that uses datasources, OJB only manages connections from DriverManager.

Note: If the concrete implementation does not callback to #newConnectionFromDriverManager(org.apache.ojb.broker.metadata.JdbcConnectionDescriptor) when creating a new Connection, it must call #initializeJdbcConnection(java.sql.Connection, org.apache.ojb.broker.metadata.JdbcConnectionDescriptor) so that the platform implementation can peform any RDBMS-specific init tasks for newly created Connection objetcs.

Specified by:

checkOutJdbcConnection in class ConnectionFactoryAbstractImpl

Parameters:

jcd - the connection descriptor for which to return a validated Connection

Returns:

a valid Connection, never null. Specific implementations must guarantee that the connection is not null and that it is valid.

Throws:

LookupException - if a valid Connection could not be obtained

releaseJdbcConnection

public void releaseJdbcConnection(JdbcConnectionDescriptor jcd,
                                  java.sql.Connection con)
                           throws LookupException

Description copied from class: ConnectionFactoryAbstractImpl

Releases a Connection after use. Implement this method in concrete subclasses. Concrete implementations using Connection pooling are responsible for any validation and pool removal management.

Note: This method is never called for a jdbc-connection-descriptor that uses datasources, OJB only manages connections from DriverManager.

Specified by:

releaseJdbcConnection in class ConnectionFactoryAbstractImpl

Parameters:

jcd - the connection descriptor for which the connection was created

con - the connection to release. Callers must guarantee that the passed connection was obtained by calling ConnectionFactoryAbstractImpl.checkOutJdbcConnection(org.apache.ojb.broker.metadata.JdbcConnectionDescriptor).

Throws:

LookupException - if errors occured during release of object. Typically happens if return of object to pool fails in a pooled implementation.