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

Class SemaphoreConcurrentLinkedDequeManagedConnectionPool

java.lang.Object

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

All Implemented Interfaces:

IdleConnectionRemovalSupport, ManagedConnectionPool

public class SemaphoreConcurrentLinkedDequeManagedConnectionPool
extends java.lang.Object
implements ManagedConnectionPool

ManagedConnectionPool implementation based on a semaphore and ConcurrentLinkedDeque

Author:

John O'Hara, Jesper Pedersen

Constructor Summary

Constructors

Constructor and Description
SemaphoreConcurrentLinkedDequeManagedConnectionPool() Constructor

Method Summary

Modifier and Type	Method and Description
void	addConnectionListener(ConnectionListener cl) Add a connection to the pool
void	connectionListenerDestroyed(ConnectionListener cl) Notify that a connection listener belonging to this pool was destroyed.
void	fillTo(int size) Fill to
ConnectionListener	findConnectionListener(javax.resource.spi.ManagedConnection mc) Find a connection listener
ConnectionListener	findConnectionListener(javax.resource.spi.ManagedConnection mc, java.lang.Object connection) Find a connection listener
void	flush(org.jboss.jca.core.api.connectionmanager.pool.FlushMode mode, java.util.Collection<ConnectionListener> toDestroy) Flush
int	getActive() Get number of active connections
ConnectionListener	getConnection(javax.security.auth.Subject subject, javax.resource.spi.ConnectionRequestInfo cri) Returns a connection listener that wraps managed connection.
long	getLastUsed() Get the last used timestamp
void	increaseCapacity(javax.security.auth.Subject subject, javax.resource.spi.ConnectionRequestInfo cri) Increase capacity
void	initialize(javax.resource.spi.ManagedConnectionFactory mcf, ConnectionManager cm, javax.security.auth.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	isIdle() Is the pool idle ?
boolean	isRunning() Checks if the pool is running or not
void	prefill() Prefill
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)
void	shutdown() Shutdown
java.lang.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

SemaphoreConcurrentLinkedDequeManagedConnectionPool

public SemaphoreConcurrentLinkedDequeManagedConnectionPool()

Constructor

Method Detail

initialize

public void initialize(javax.resource.spi.ManagedConnectionFactory mcf,
                       ConnectionManager cm,
                       javax.security.auth.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

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

prefill

public void prefill()

Prefill

Specified by:

prefill in interface ManagedConnectionPool

getConnection

public ConnectionListener getConnection(javax.security.auth.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,
                                                 java.lang.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

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)

flush

public void flush(org.jboss.jca.core.api.connectionmanager.pool.FlushMode mode,
                  java.util.Collection<ConnectionListener> toDestroy)

Flush

Specified by:

flush in interface ManagedConnectionPool

Parameters:

mode - The flush mode

toDestroy - list of connection listeners to be destroyed

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

increaseCapacity

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

Description copied from interface: ManagedConnectionPool

Increase capacity

Specified by:

increaseCapacity in interface ManagedConnectionPool

Parameters:

subject - The subject

cri - The connection request information object

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

connectionListenerDestroyed

public void connectionListenerDestroyed(ConnectionListener cl)

Notify that a connection listener belonging to this pool was destroyed.

Specified by:

connectionListenerDestroyed in interface ManagedConnectionPool

validateConnections

public void validateConnections()
                         throws java.lang.Exception

Validate connecitons.

Specified by:

validateConnections in interface ManagedConnectionPool

Throws:

java.lang.Exception - for exception

toString

public java.lang.String toString()

String representation

Overrides:

toString in class java.lang.Object

Returns:

The string