edu.internet2.middleware.subject.provider

Interface JdbcConnectionBean

All Known Implementing Classes:

C3p0JdbcConnectionProvider.C3p0JdbcConnectionBean, GrouperJdbcConnectionProvider.GrouperJdbcConnectionBean

public interface JdbcConnectionBean

bean that wraps connections

Method Summary

Methods

Modifier and Type	Method and Description
Connection	connection() get a connection (dont close this when done, just call "doneWithConnection()"
void	doneWithConnection() call this when the connection is done.
void	doneWithConnectionError(Throwable t) call this when the connection is done but there was an error, will pass an exception.
void	doneWithConnectionFinally() call this when the connection is not needed, in the finally block this might return to pool.

Method Detail

connection

Connection connection()
                      throws SQLException

get a connection (dont close this when done, just call "doneWithConnection()"

Returns:

the connection

Throws:

SQLException - if there is a problem

doneWithConnection

void doneWithConnection()
                        throws SQLException

call this when the connection is done. This will do any cleanup this is a null-safe method.

Throws:

SQLException - if there is a problem

doneWithConnectionFinally

void doneWithConnectionFinally()

call this when the connection is not needed, in the finally block this might return to pool. In general, this shouldnt throw exceptions since it is done in a finally block, it should only log them

doneWithConnectionError

void doneWithConnectionError(Throwable t)

call this when the connection is done but there was an error, will pass an exception. This should do whatever and rethrow the exception as runtime

Parameters:

t -