FileDocCategorySizeDatePackage
JBossManagedConnectionPoolMBean.javaAPI DocJBoss 4.2.18097Fri Jul 13 21:01:18 BST 2007org.jboss.resource.connectionmanager

JBossManagedConnectionPoolMBean

public interface JBossManagedConnectionPoolMBean implements org.jboss.system.ServiceMBean
A JBossManagedConnectionPoolMBean.
author
Adrian Brock
author
Weston Price
version
$Revision: 59880 $

Fields Summary
public static final ObjectName
OBJECT_NAME
Constructors Summary
Methods Summary
public voidflush()
The flush method puts all currently checked out connections on a list to be destroyed when returned and disposes of all current pooled connections.

public longgetAvailableConnectionCount()
Get number of available free connections

return
number of available connections

public booleangetBackGroundValidation()
Get background validation

return
true of false if background validation is enabled.

public longgetBackGroundValidationMinutes()
Get the background validation in minutes

return
the background validation in minutes

public intgetBlockingTimeoutMillis()
The BlockingTimeoutMillis attribute indicates the maximum time to block while waiting for a connection before throwing an exception. Note that this blocks only while waiting for a permit for a connection, and will never throw an exception if creating a new connection takes an inordinately long time.

return
the BlockingTimeout value.

public intgetConnectionCount()
Retrieve the connection count.

return
the connection count

public intgetConnectionCreatedCount()
Retrieve the connection created count.

return
the connection created count

public intgetConnectionDestroyedCount()
Retrieve the destrooyed count.

return
the destroyed count

public java.lang.StringgetCriteria()
The Criteria attribute indicates if Subject (from security domain) or app supplied parameters (such as from getConnection(user, pw)) are used to distinguish connections in the pool. Choices are ByContainerAndApplication (use both), ByContainer (use Subject), ByApplication (use app supplied params only), ByNothing (all connections are equivalent, usually if adapter supports reauthentication)

return
the Criteria value.

public longgetIdleTimeoutMinutes()
The IdleTimeoutMinutes attribute indicates the maximum time a connection may be idle before being closed. The actual maximum time depends also on the IdleRemover scan time, which is 1/2 the smallest IdleTimeout of any pool.

return
the IdleTimeoutMinutes value.

public longgetInUseConnectionCount()
Get number of connections currently in use

return
number of connections currently in use

public javax.management.ObjectNamegetManagedConnectionFactoryName()
ManagedConnectionFactoryName holds the ObjectName of the mbean that represents the ManagedConnectionFactory. Normally this can be an embedded mbean in a depends element rather than a separate mbean reference.

return
the ManagedConnectionFactoryName value.

public org.jboss.resource.connectionmanager.ManagedConnectionPoolgetManagedConnectionPool()
ManagedConnectionPool is a read only attribute returning the pool set up by this mbean.

return
the ManagedConnectionPool implementing the pool configured by this mbean.

public longgetMaxConnectionsInUseCount()

public intgetMaxSize()
The MaxSize attribute indicates the maximum number of connections for a pool. No more than MaxSize connections will be created in each sub-pool.

return
the MaxSize value.

public intgetMinSize()
The MinSize attribute indicates the minimum number of connections this pool should hold. These are not created until a Subject is known from a request for a connection. MinSize connections will be created for each sub-pool.

return
the MinSize value.

public booleangetNoTxSeparatePools()
Separate pools for transactional use

return
true when connections should have different pools for transactional and non-transaction use.

public java.lang.StringgetPoolJndiName()
Get the jndi name of the pool

return
the jndi name of the pool.

public booleangetPreFill()
Get prefill

return
true or false depending upon prefill being set

public booleangetUseFastFail()
Whether or not we want to immeadiately create a new connection when an attempt to acquire a connection from the pool fails.

return
true of false depending upon whether fast fail is being used.

public voidsetBackGroundValidation(boolean backgroundValidation)
Set the background validation

param
backgroundValidation true or false if background validation is to be enabled

public voidsetBackGroundValidationMinutes(long backgroundValidationInterval)
Set the background validation in minutes

param
backgroundValidationInterval the background interval in minutes

public voidsetBlockingTimeoutMillis(int newBlockingTimeout)
Set the BlockingTimeout value.

param
newBlockingTimeout The new BlockingTimeout value.

public voidsetCriteria(java.lang.String newCriteria)
Set the Criteria value.

param
newCriteria The new Criteria value.

public voidsetIdleTimeoutMinutes(long newIdleTimeoutMinutes)
Set the IdleTimeoutMinutes value.

param
newIdleTimeoutMinutes The new IdleTimeoutMinutes value.

public voidsetManagedConnectionFactoryName(javax.management.ObjectName newManagedConnectionFactoryName)
Set the ManagedConnectionFactoryName value.

param
newManagedConnectionFactoryName The new ManagedConnectionFactoryName value.

public voidsetMaxSize(int newMaxSize)
Set the MaxSize value.

param
newMaxSize The new MaxSize value.

public voidsetMinSize(int newMinSize)
Set the MinSize value.

param
newMinSize The new MinSize value.

public voidsetNoTxSeparatePools(boolean value)

public voidsetPoolJndiName(java.lang.String poolName)
Set the jndi name of the pool.

param
poolName the jndi name of the pool.

public voidsetPreFill(boolean prefill)
Set the prefill

param
prefill true or false depending upon if prefill is being used

public voidsetUseFastFail(boolean useFastFail)
Indicate whether or not we want to immeadiately create a new connection when an attempt to acquire a connection from the pool fails.

param
useFastFail whether or not we want to use fast fail semantics in a connection attempt.