Package overit.geocall.da

Class PoolKit.Transaction

java.lang.Object

overit.geocall.da.PoolKit.Transaction

Enclosing class:

PoolKit

public static class PoolKit.Transaction
extends Object

Method Summary

Modifier and Type	Method	Description
PooledConnection	advance()	Get the connection currently used by this transaction
PooledConnection	start(String pool, boolean service, String description)	Extract a new PooledConnection from the specified Pool.
PooledConnection	start(String pool, String description)	Extract a new PooledConnection from the specified Pool.
PooledConnection	startOrAdvance(String pool, boolean service, String description)	Get the connection currently used by this transaction or extract a new PooledConnection from the specified Pool if it is not extracted yet.
PooledConnection	startOrAdvance(String pool, String description)	Get the connection currently used by this transaction or extract a new PooledConnection from the specified Pool if it is not extracted yet.

Methods inherited from class java.lang.Object

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

Method Details

start

public PooledConnection start(String pool,
 String description)
                       throws DAException

Extract a new PooledConnection from the specified Pool. This method must be used only the first time you want to extract a connection from the pool; if you wnat to reuse it use the advance() or startOrAdvance(String, String) methods

Parameters:

pool - the pool's name

description - the operation description

Returns:

the connection extracted from the pool

Throws:

DAException - in case of database error

start

public PooledConnection start(String pool,
 boolean service,
 String description)
                       throws DAException

Extract a new PooledConnection from the specified Pool. This method must be used only the first time you want to extract a connection from the pool; if you wnat to reuse it use the advance() or startOrAdvance(String, String) methods

Parameters:

pool - the pool's name

service - true to extract the connection from the service's pool

description - the operation description

Returns:

the connection extracted from the pool

Throws:

DAException - in case of database error

advance

public PooledConnection advance()
                         throws DAException

Get the connection currently used by this transaction

Returns:

the connection currently used by this transaction

Throws:

DAException - in case of database error

startOrAdvance

public PooledConnection startOrAdvance(String pool,
 String description)
                                throws DAException

Get the connection currently used by this transaction or extract a new PooledConnection from the specified Pool if it is not extracted yet.

Parameters:

pool - the pool's name

description - the operation description

Returns:

the connection extracted from the pool

Throws:

DAException - in case of database error

startOrAdvance

public PooledConnection startOrAdvance(String pool,
 boolean service,
 String description)
                                throws DAException

Get the connection currently used by this transaction or extract a new PooledConnection from the specified Pool if it is not extracted yet.

Parameters:

pool - the pool's name

service - true to extract the connection from the service's pool

description - the operation description

Returns:

the connection extracted from the pool

Throws:

DAException - in case of database error