com.sun.enterprise.resource.pool

Class PoolLifeCycleListenerRegistry

java.lang.Object

com.sun.enterprise.resource.pool.PoolLifeCycleListenerRegistry

All Implemented Interfaces:

PoolLifeCycleListener

public class PoolLifeCycleListenerRegistry
extends Object
implements PoolLifeCycleListener

Implementation of PoolLifeCycleListener to listen to events related to a connection pool. The registry allows multiple listeners (ex: pool monitoring) to listen to the pool's lifecyle. Maintains a list of listeners for this pool identified by poolName.

Author:

Shalini M

Field Summary

Fields

Modifier and Type	Field and Description
protected List<PoolLifeCycleListener>	poolListenersList

Constructor Summary

Constructors

Constructor and Description
PoolLifeCycleListenerRegistry(PoolInfo poolInfo)

Method Summary

Modifier and Type	Method and Description
void	connectionAcquired(long resourceHandleId) indicates that a connection is acquired by application
void	connectionCreated() indicates that a new connection is created
void	connectionDestroyed(long resourceHandleId) indicates that a connection is destroyed
void	connectionMatched() indicates that a connection under test matches the current request
void	connectionNotMatched() indicates that a connection under test does not match the current request
void	connectionReleased(long resourceHandleId) indicates that a connection is released
void	connectionRequestDequeued() indicates that the wait queue length has decreased.
void	connectionRequestQueued() indicates that the wait queue length has increased.
void	connectionRequestServed(long timeTakenInMillis) indicates that a connection request is server in the time
void	connectionsFreed(int count) indicates the number of connections freed to pool
void	connectionTimedOut() indicates that a connection is timed-out
void	connectionUsed(long resourceHandleId) indicates that a connection is being used
void	connectionValidationFailed(int count) indicates that a number of connections have failed validation
void	decrementConnectionUsed(long resourceHandleId) indicates that connection count that is used has to be decremented.
void	decrementNumConnFree() indicates that free connections count in the pool has to be decremented.
void	foundPotentialConnectionLeak() indicates that a potential connection leak happened
void	incrementNumConnFree(boolean beingDestroyed, int steadyPoolSize) indicates that a connection is freed and the count is to be incremented.
void	registerPoolLifeCycleListener(PoolLifeCycleListener listener) Add a listener to the list of pool life cycle listeners maintained by this registry.
void	toString(StringBuilder stackTrace) Print stack trace in server.log
void	unRegisterPoolLifeCycleListener(PoolInfo poolInfo) Clear the list of pool lifecycle listeners maintained by the registry.

Methods inherited from class java.lang.Object

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

Field Detail

poolListenersList

protected List<PoolLifeCycleListener> poolListenersList

Constructor Detail

PoolLifeCycleListenerRegistry

public PoolLifeCycleListenerRegistry(PoolInfo poolInfo)

Method Detail

registerPoolLifeCycleListener

public void registerPoolLifeCycleListener(PoolLifeCycleListener listener)

Add a listener to the list of pool life cycle listeners maintained by this registry.

Parameters:

listener -

unRegisterPoolLifeCycleListener

public void unRegisterPoolLifeCycleListener(PoolInfo poolInfo)

Clear the list of pool lifecycle listeners maintained by the registry. This happens when a pool is destroyed so the information about its listeners need not be stored.

Parameters:

poolName -

toString

public void toString(StringBuilder stackTrace)

Description copied from interface: PoolLifeCycleListener

Print stack trace in server.log

Specified by:

toString in interface PoolLifeCycleListener

connectionAcquired

public void connectionAcquired(long resourceHandleId)

Description copied from interface: PoolLifeCycleListener

indicates that a connection is acquired by application

Specified by:

connectionAcquired in interface PoolLifeCycleListener

connectionRequestServed

public void connectionRequestServed(long timeTakenInMillis)

Description copied from interface: PoolLifeCycleListener

indicates that a connection request is server in the time

Specified by:

connectionRequestServed in interface PoolLifeCycleListener

Parameters:

timeTakenInMillis - time taken to serve a connection

connectionTimedOut

public void connectionTimedOut()

Description copied from interface: PoolLifeCycleListener

indicates that a connection is timed-out

Specified by:

connectionTimedOut in interface PoolLifeCycleListener

connectionNotMatched

public void connectionNotMatched()

Description copied from interface: PoolLifeCycleListener

indicates that a connection under test does not match the current request

Specified by:

connectionNotMatched in interface PoolLifeCycleListener

connectionMatched

public void connectionMatched()

Description copied from interface: PoolLifeCycleListener

indicates that a connection under test matches the current request

Specified by:

connectionMatched in interface PoolLifeCycleListener

connectionUsed

public void connectionUsed(long resourceHandleId)

Description copied from interface: PoolLifeCycleListener

indicates that a connection is being used

Specified by:

connectionUsed in interface PoolLifeCycleListener

connectionDestroyed

public void connectionDestroyed(long resourceHandleId)

Description copied from interface: PoolLifeCycleListener

indicates that a connection is destroyed

Specified by:

connectionDestroyed in interface PoolLifeCycleListener

connectionReleased

public void connectionReleased(long resourceHandleId)

Description copied from interface: PoolLifeCycleListener

indicates that a connection is released

Specified by:

connectionReleased in interface PoolLifeCycleListener

connectionCreated

public void connectionCreated()

Description copied from interface: PoolLifeCycleListener

indicates that a new connection is created

Specified by:

connectionCreated in interface PoolLifeCycleListener

foundPotentialConnectionLeak

public void foundPotentialConnectionLeak()

Description copied from interface: PoolLifeCycleListener

indicates that a potential connection leak happened

Specified by:

foundPotentialConnectionLeak in interface PoolLifeCycleListener

connectionValidationFailed

public void connectionValidationFailed(int count)

Description copied from interface: PoolLifeCycleListener

indicates that a number of connections have failed validation

Specified by:

connectionValidationFailed in interface PoolLifeCycleListener

Parameters:

count - number of connections

connectionsFreed

public void connectionsFreed(int count)

Description copied from interface: PoolLifeCycleListener

indicates the number of connections freed to pool

Specified by:

connectionsFreed in interface PoolLifeCycleListener

Parameters:

count - number of connections

decrementConnectionUsed

public void decrementConnectionUsed(long resourceHandleId)

Description copied from interface: PoolLifeCycleListener

indicates that connection count that is used has to be decremented.

Specified by:

decrementConnectionUsed in interface PoolLifeCycleListener

decrementNumConnFree

public void decrementNumConnFree()

Description copied from interface: PoolLifeCycleListener

indicates that free connections count in the pool has to be decremented.

Specified by:

decrementNumConnFree in interface PoolLifeCycleListener

incrementNumConnFree

public void incrementNumConnFree(boolean beingDestroyed,
                                 int steadyPoolSize)

Description copied from interface: PoolLifeCycleListener

indicates that a connection is freed and the count is to be incremented.

Specified by:

incrementNumConnFree in interface PoolLifeCycleListener

Parameters:

beingDestroyed - in case of an error.

connectionRequestQueued

public void connectionRequestQueued()

Description copied from interface: PoolLifeCycleListener

indicates that the wait queue length has increased.

Specified by:

connectionRequestQueued in interface PoolLifeCycleListener

connectionRequestDequeued

public void connectionRequestDequeued()

Description copied from interface: PoolLifeCycleListener

indicates that the wait queue length has decreased.

Specified by:

connectionRequestDequeued in interface PoolLifeCycleListener