Class ConnectionContext

java.lang.Object

org.deltava.jdbc.ConnectionContext

Direct Known Subclasses:

HTTPContext, TaskContext

public abstract class ConnectionContext
extends Object

A Context object that allows fetching of connections from a JDBC connection pool.

Since:

1.0

Version:

11.4

Author:

Luke

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ConnectionContext.ConnectionPoolException

Constructor Summary

Constructors

Constructor	Description
ConnectionContext()

Method Summary

Modifier and Type	Method	Description
void	commitTX()	Commits the current JDBC transaction.
Connection	getConnection()	Reserves a JDBC Connection from the connection pool.
String	getDB()	Returns the default database name.
boolean	hasConnection()	Returns whether a JDBC connection has been reserved by this context.
long	release()	Returns a JDBC Connection to the connection pool.
void	rollbackTX()	Rolls back the current JDBC transaction.
void	setDB(String dbName)	Updates the default database name.
void	startTX()	Starts a JDBC transaction block, by turning off autoCommit on the reserved Connection.

Methods inherited from class java.lang.Object

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

Constructor Details

ConnectionContext

public ConnectionContext()

Method Details

getConnection

public Connection getConnection()
                         throws ConnectionContext.ConnectionPoolException

Reserves a JDBC Connection from the connection pool.

Returns:

a JDBC Connection

Throws:

ConnectionContext.ConnectionPoolException - if an error occurs

IllegalStateException - if a connection has already been reserved by this context

See Also:

• getConnection()
• release()

hasConnection

public boolean hasConnection()

Returns whether a JDBC connection has been reserved by this context.

Returns:

TRUE if a Connection has been reserved, otherwise FALSE

getDB

public String getDB()

Returns the default database name.

Returns:

the database name

setDB

public void setDB(String dbName)

Updates the default database name.

Parameters:

dbName - the database name

startTX

public void startTX()
             throws TransactionException

Starts a JDBC transaction block, by turning off autoCommit on the reserved Connection.

Throws:

IllegalStateException - if no JDBC Connection is reserved

TransactionException - if a JDBC error occurs

commitTX

public void commitTX()
              throws TransactionException

Commits the current JDBC transaction.

Throws:

IllegalStateException - if no JDBC Connection is reserved

TransactionException - if a JDBC error occurs

rollbackTX

public void rollbackTX()

Rolls back the current JDBC transaction. This will consume all exceptions.

release

public long release()

Returns a JDBC Connection to the connection pool.

Returns:

the time the connection was in use, in milliseconds