de.tmasoft.acaf.jdbc

Class JdbcThreadManagedConnectionAccess

java.lang.Object

de.tmasoft.acaf.jdbc.JdbcThreadManagedConnectionAccess

All Implemented Interfaces:

JdbcConnectionAccessInterface

Direct Known Subclasses:

JdbcThreadManagedDataSourceConnectionAccess

public class JdbcThreadManagedConnectionAccess
extends java.lang.Object
implements JdbcConnectionAccessInterface

This connection access manages connections for threads. The method setConnection(Connection) sets the connection of the current thread, which is afterwards returned by the method getConnection(). The method closeConnection() closes and releases the connection for the current thread. The method releaseConnection() is empty and has no effect.

This connection access can be used in a multi threaded application as part of a singleton.

Constructor Summary

Constructors

Constructor and Description
JdbcThreadManagedConnectionAccess()

Method Summary

Modifier and Type	Method and Description
void	closeConnection() This method implements the interface JdbcConnectionAccessInterface and closes and releases the database connection of the current thread.
java.sql.Connection	getConnection() This method implements the interface JdbcConnectionAccessInterface and returns the database connection for the current thread.
void	releaseConnection() This method implements the interface JdbcConnectionAccessInterface with an empty implementation.
void	setConnection(java.sql.Connection connection) This method implements the interface JdbcConnectionAccessInterface to sets the passed connection for the current thread.

Methods inherited from class java.lang.Object

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

Constructor Detail

JdbcThreadManagedConnectionAccess

public JdbcThreadManagedConnectionAccess()

Method Detail

closeConnection

public void closeConnection()
                     throws JdbcGeneralError

This method implements the interface JdbcConnectionAccessInterface and closes and releases the database connection of the current thread.

Specified by:

closeConnection in interface JdbcConnectionAccessInterface

Throws:

JdbcGeneralError - Thrown, when closing the connection fails.

getConnection

public java.sql.Connection getConnection()
                                  throws JdbcGeneralError

This method implements the interface JdbcConnectionAccessInterface and returns the database connection for the current thread.

Specified by:

getConnection in interface JdbcConnectionAccessInterface

Returns:

The connection.

Throws:

JdbcGeneralError - May be thrown by derived classes.

releaseConnection

public void releaseConnection()
                       throws JdbcGeneralError

This method implements the interface JdbcConnectionAccessInterface with an empty implementation.

Specified by:

releaseConnection in interface JdbcConnectionAccessInterface

Throws:

JdbcGeneralError - May be thrown by derived classes.

setConnection

public void setConnection(java.sql.Connection connection)

This method implements the interface JdbcConnectionAccessInterface to sets the passed connection for the current thread. After calling this method, the method getConnection() returns the passed connection for the current thread. A previously connection opened by the current thread is discarded and no longer accessible via this class. When null is passed as connection, the connection of the current thread is removed, but not closed.

Specified by:

setConnection in interface JdbcConnectionAccessInterface

Parameters:

connection - The connection to be set, or null when the connection should be removed for the current thread.