com.jolbox.bonecp

Class ConnectionPartition

java.lang.Object

com.jolbox.bonecp.ConnectionPartition

All Implemented Interfaces:

Serializable

public class ConnectionPartition
extends Object
implements Serializable

Connection Partition structure

Author:

wwadge

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
protected BoneCP	pool Handle to the pool.
protected ReentrantReadWriteLock	statsLock Statistics lock.

Constructor Summary

Constructors

Constructor and Description
ConnectionPartition(BoneCP pool) Partition constructor

Method Summary

Methods

Modifier and Type	Method and Description
protected void	addFreeConnection(ConnectionHandle connectionHandle) Adds a free connection.
protected int	getAcquireIncrement()
protected int	getAvailableConnections() Returns the number of avail connections
protected int	getCreatedConnections()
protected BlockingQueue<ConnectionHandle>	getFreeConnections()
protected int	getMaxConnections()
protected int	getMinConnections()
protected String	getPassword()
protected BlockingQueue<Object>	getPoolWatchThreadSignalQueue() Returns a handle to the poolWatchThreadSignalQueue
protected long	getQueryExecuteTimeLimitinNanoSeconds() Store the unit translation here to avoid recalculating it in the constructor of StatementHandle.
int	getRemainingCapacity() Returns no of free slots.
protected String	getUrl()
protected String	getUsername()
protected boolean	isUnableToCreateMoreTransactions() Returns true if we have created all the connections we can
protected void	setFreeConnections(BlockingQueue<ConnectionHandle> freeConnections)
protected void	setUnableToCreateMoreTransactions(boolean unableToCreateMoreTransactions) Sets connection creation possible status
String	toString()
protected void	trackConnectionFinalizer(ConnectionHandle connectionHandle) This method is a replacement for finalize() but avoids all its pitfalls (see Joshua Bloch et.
protected void	updateCreatedConnections(int increment) Updates leased connections statistics

Methods inherited from class java.lang.Object

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

Field Detail

statsLock

protected ReentrantReadWriteLock statsLock

Statistics lock.

pool

protected BoneCP pool

Handle to the pool.

Constructor Detail

ConnectionPartition

public ConnectionPartition(BoneCP pool)

Partition constructor

Parameters:

pool - handle to connection pool

Method Detail

getPoolWatchThreadSignalQueue

protected BlockingQueue<Object> getPoolWatchThreadSignalQueue()

Returns a handle to the poolWatchThreadSignalQueue

Returns:

the poolWatchThreadSignal

updateCreatedConnections

protected void updateCreatedConnections(int increment)

Updates leased connections statistics

Parameters:

increment - value to add/subtract

addFreeConnection

protected void addFreeConnection(ConnectionHandle connectionHandle)
                          throws SQLException

Adds a free connection.

Parameters:

connectionHandle -

Throws:

SQLException - on error

trackConnectionFinalizer

protected void trackConnectionFinalizer(ConnectionHandle connectionHandle)

This method is a replacement for finalize() but avoids all its pitfalls (see Joshua Bloch et. all). Keeps a handle on the connection. If the application called closed, then it means that the handle gets pushed back to the connection pool and thus we get a strong reference again. If the application forgot to call close() and subsequently lost the strong reference to it, the handle becomes eligible to garbage connection and thus the the finalizeReferent method kicks in to safely close off the database handle. Note that we do not return the connectionHandle back to the pool since that is not possible (for otherwise the GC would not have kicked in), but we merely safely release the database internal handle and update our counters instead.

Parameters:

connectionHandle - handle to watch

getFreeConnections

protected BlockingQueue<ConnectionHandle> getFreeConnections()

Returns:

the freeConnections

setFreeConnections

protected void setFreeConnections(BlockingQueue<ConnectionHandle> freeConnections)

Parameters:

freeConnections - the freeConnections to set

getAcquireIncrement

protected int getAcquireIncrement()

Returns:

the acquireIncrement

getMinConnections

protected int getMinConnections()

Returns:

the minConnections

getMaxConnections

protected int getMaxConnections()

Returns:

the maxConnections

getCreatedConnections

protected int getCreatedConnections()

Returns:

the leasedConnections

getUrl

protected String getUrl()

Returns:

the url

getUsername

protected String getUsername()

Returns:

the username

getPassword

protected String getPassword()

Returns:

the password

isUnableToCreateMoreTransactions

protected boolean isUnableToCreateMoreTransactions()

Returns true if we have created all the connections we can

Returns:

true if we have created all the connections we can

setUnableToCreateMoreTransactions

protected void setUnableToCreateMoreTransactions(boolean unableToCreateMoreTransactions)

Sets connection creation possible status

Parameters:

unableToCreateMoreTransactions - t/f

getAvailableConnections

protected int getAvailableConnections()

Returns the number of avail connections

Returns:

avail connections.

getRemainingCapacity

public int getRemainingCapacity()

Returns no of free slots.

Returns:

remaining capacity.

getQueryExecuteTimeLimitinNanoSeconds

protected long getQueryExecuteTimeLimitinNanoSeconds()

Store the unit translation here to avoid recalculating it in the constructor of StatementHandle.

Returns:

value

toString

public String toString()

Overrides:

toString in class Object