com.sun.enterprise.resource.listener

Interface PoolLifeCycleListener

All Known Implementing Classes:

ConnectionPoolEmitterImpl, PoolLifeCycleListenerRegistry

public interface PoolLifeCycleListener

Pool Life cycle listener that can be implemented by listeners for pool monitoring

Author:

Jagadish Ramu

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	toString(StringBuffer stackTrace) Print stack trace in server.log

Method Detail

toString

void toString(StringBuffer stackTrace)

Print stack trace in server.log

Parameters:

stackTrace -

connectionAcquired

void connectionAcquired(long resourceHandleId)

indicates that a connection is acquired by application

connectionRequestServed

void connectionRequestServed(long timeTakenInMillis)

indicates that a connection request is server in the time

Parameters:

timeTakenInMillis - time taken to serve a connection

connectionTimedOut

void connectionTimedOut()

indicates that a connection is timed-out

connectionNotMatched

void connectionNotMatched()

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

connectionMatched

void connectionMatched()

indicates that a connection under test matches the current request

connectionUsed

void connectionUsed(long resourceHandleId)

indicates that a connection is being used

connectionDestroyed

void connectionDestroyed(long resourceHandleId)

indicates that a connection is destroyed

connectionReleased

void connectionReleased(long resourceHandleId)

indicates that a connection is released

connectionCreated

void connectionCreated()

indicates that a new connection is created

foundPotentialConnectionLeak

void foundPotentialConnectionLeak()

indicates that a potential connection leak happened

connectionValidationFailed

void connectionValidationFailed(int count)

indicates that a number of connections have failed validation

Parameters:

count - number of connections

connectionsFreed

void connectionsFreed(int count)

indicates the number of connections freed to pool

Parameters:

count - number of connections

decrementConnectionUsed

void decrementConnectionUsed(long resourceHandleId)

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

decrementNumConnFree

void decrementNumConnFree()

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

incrementNumConnFree

void incrementNumConnFree(boolean beingDestroyed,
                          int steadyPoolSize)

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

Parameters:

beingDestroyed - in case of an error.

steadyPoolSize -

connectionRequestQueued

void connectionRequestQueued()

indicates that the wait queue length has increased.

connectionRequestDequeued

void connectionRequestDequeued()

indicates that the wait queue length has decreased.