org.jboss.jca.core.connectionmanager.pool.mcp

Class ArrayBlockingQueueManagedConnectionPool

java.lang.Object

org.jboss.jca.core.connectionmanager.pool.mcp.ArrayBlockingQueueManagedConnectionPool

All Implemented Interfaces:

IdleConnectionRemovalSupport, ManagedConnectionPool

public class ArrayBlockingQueueManagedConnectionPool
extends Object
implements ManagedConnectionPool

A managed connection pool implementation using ArrayBlockingQueue

Author:

Jesper Pedersen

Constructor Summary

Constructors

Constructor and Description
ArrayBlockingQueueManagedConnectionPool() Constructor

Method Summary

Methods

Modifier and Type	Method and Description
void	addConnectionListener(ConnectionListener cl) Add a connection to the pool
void	fillTo(int size) Fill to
ConnectionListener	findConnectionListener(javax.resource.spi.ManagedConnection mc) Find a connection listener
ConnectionListener	findConnectionListener(javax.resource.spi.ManagedConnection mc, Object connection) Find a connection listener
void	flush(org.jboss.jca.core.api.connectionmanager.pool.FlushMode mode) Flush
int	getActive() Get number of active connections
ConnectionListener	getConnection(Subject subject, javax.resource.spi.ConnectionRequestInfo cri) Returns a connection listener that wraps managed connection.
long	getLastUsed() Get the last used timestamp
ManagedConnectionPoolStatistics	getStatistics() Get statistics
void	increaseCapacity(Subject subject, javax.resource.spi.ConnectionRequestInfo cri) Increase capacity
void	initialize(javax.resource.spi.ManagedConnectionFactory mcf, ConnectionManager cm, Subject subject, javax.resource.spi.ConnectionRequestInfo cri, org.jboss.jca.core.api.connectionmanager.pool.PoolConfiguration pc, Pool p) Initialize the managed connection pool
boolean	isEmpty() Checks if the pool is empty or not
boolean	isFull() Is the pool full ?
boolean	isIdle() Is the pool idle ?
boolean	isRunning() Checks if the pool is running or not
void	prefill() Prefill
void	reenable() Reenable a pool
ConnectionListener	removeConnectionListener() Remove an idle connection from the pool
void	removeIdleConnections() Pool removes idle connections.
void	returnConnection(ConnectionListener cl, boolean kill) Return connection to the pool.
void	returnConnection(ConnectionListener cl, boolean kill, boolean cleanup) Return a connection to the pool
void	shutdown() Shutdown
String	toString() String representation
void	validateConnections() Validate connecitons.

Methods inherited from class java.lang.Object

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

Constructor Detail

ArrayBlockingQueueManagedConnectionPool

public ArrayBlockingQueueManagedConnectionPool()

Constructor

Method Detail

initialize

public void initialize(javax.resource.spi.ManagedConnectionFactory mcf,
              ConnectionManager cm,
              Subject subject,
              javax.resource.spi.ConnectionRequestInfo cri,
              org.jboss.jca.core.api.connectionmanager.pool.PoolConfiguration pc,
              Pool p)

Initialize the managed connection pool

Specified by:

initialize in interface ManagedConnectionPool

Parameters:

mcf - The managed connection factory

cm - The connection manager

subject - The subject

cri - The connection request info

pc - The pool configuration

p - The pool

getLastUsed

public long getLastUsed()

Get the last used timestamp

Specified by:

getLastUsed in interface ManagedConnectionPool

Returns:

The value

isRunning

public boolean isRunning()

Checks if the pool is running or not

Specified by:

isRunning in interface ManagedConnectionPool

Returns:

True if is running; otherwise false

isEmpty

public boolean isEmpty()

Checks if the pool is empty or not

Specified by:

isEmpty in interface ManagedConnectionPool

Returns:

True if is emtpy; otherwise false

isFull

public boolean isFull()

Is the pool full ?

Specified by:

isFull in interface ManagedConnectionPool

Returns:

True if full, otherwise false

isIdle

public boolean isIdle()

Is the pool idle ?

Specified by:

isIdle in interface ManagedConnectionPool

Returns:

True if idle, otherwise false

getActive

public int getActive()

Get number of active connections

Specified by:

getActive in interface ManagedConnectionPool

Returns:

The value

reenable

public void reenable()

Reenable a pool

Specified by:

reenable in interface ManagedConnectionPool

prefill

public void prefill()

Prefill

Specified by:

prefill in interface ManagedConnectionPool

getConnection

public ConnectionListener getConnection(Subject subject,
                               javax.resource.spi.ConnectionRequestInfo cri)
                                 throws javax.resource.ResourceException

Returns a connection listener that wraps managed connection.

Specified by:

getConnection in interface ManagedConnectionPool

Parameters:

subject - subject

cri - connection request info

Returns:

connection listener wrapped managed connection

Throws:

javax.resource.ResourceException - exception

findConnectionListener

public ConnectionListener findConnectionListener(javax.resource.spi.ManagedConnection mc)

Find a connection listener

Specified by:

findConnectionListener in interface ManagedConnectionPool

Parameters:

mc - The managed connection

Returns:

The connection listener; null if the connection listener doesn't belong

findConnectionListener

public ConnectionListener findConnectionListener(javax.resource.spi.ManagedConnection mc,
                                        Object connection)

Find a connection listener

Specified by:

findConnectionListener in interface ManagedConnectionPool

Parameters:

mc - The managed connection

connection - The connection

Returns:

The connection listener; null if the connection listener doesn't belong

addConnectionListener

public void addConnectionListener(ConnectionListener cl)

Add a connection to the pool

Specified by:

addConnectionListener in interface ManagedConnectionPool

Parameters:

cl - The connection listener

removeConnectionListener

public ConnectionListener removeConnectionListener()

Remove an idle connection from the pool

Specified by:

removeConnectionListener in interface ManagedConnectionPool

Returns:

A connection listener; null if no connection listener was available

returnConnection

public void returnConnection(ConnectionListener cl,
                    boolean kill)

Return connection to the pool.

Specified by:

returnConnection in interface ManagedConnectionPool

Parameters:

cl - connection listener

kill - kill connection

returnConnection

public void returnConnection(ConnectionListener cl,
                    boolean kill,
                    boolean cleanup)

Return a connection to the pool

Parameters:

cl - The connection listener

kill - Should the connection be killed

cleanup - Should cleanup be performed

flush

public void flush(org.jboss.jca.core.api.connectionmanager.pool.FlushMode mode)

Flush

Specified by:

flush in interface ManagedConnectionPool

Parameters:

mode - The flush mode

removeIdleConnections

public void removeIdleConnections()

Pool removes idle connections.

Specified by:

removeIdleConnections in interface IdleConnectionRemovalSupport

shutdown

public void shutdown()

Shutdown

Specified by:

shutdown in interface ManagedConnectionPool

fillTo

public void fillTo(int size)

Fill to

Specified by:

fillTo in interface ManagedConnectionPool

Parameters:

size - The size

getStatistics

public ManagedConnectionPoolStatistics getStatistics()

Get statistics

Specified by:

getStatistics in interface ManagedConnectionPool

Returns:

The module

increaseCapacity

public void increaseCapacity(Subject subject,
                    javax.resource.spi.ConnectionRequestInfo cri)

Increase capacity

Specified by:

increaseCapacity in interface ManagedConnectionPool

Parameters:

subject - The subject

cri - The connection request information object

validateConnections

public void validateConnections()
                         throws Exception

Validate connecitons.

Specified by:

validateConnections in interface ManagedConnectionPool

Throws:

Exception - for exception

toString

public String toString()

String representation

Overrides:

toString in class Object

Returns:

The string