com.sun.enterprise.resource.pool

Interface PoolManager

All Superinterfaces:

TransactedPoolManager

All Known Implementing Classes:

AbstractPoolManager, PoolManagerImpl

@Contract
public interface PoolManager
extends TransactedPoolManager

PoolManager manages jdbc and connector connection pool

Field Summary

Fields

Modifier and Type	Field and Description
static int	BASIC_PASSWORD
static String	GENERIC_CREDENTIAL
static int	KERBV5
static int	LOCAL_TRANSACTION
static int	NO_TRANSACTION
static String	PASSWORD_CREDENTIAL
static int	XA_TRANSACTION

Method Summary

Modifier and Type	Method and Description
void	badResourceClosed(ResourceHandle res)
void	createEmptyConnectionPool(PoolInfo poolInfo, ConnectorConstants.PoolType pt, Hashtable env)
void	emptyResourcePool(ResourceSpec spec)
boolean	flushConnectionPool(PoolInfo poolInfo) Flush Connection pool by reinitializing the connections established in the pool.
ResourcePool	getPool(PoolInfo poolInfo)
PoolStatus	getPoolStatus(PoolInfo poolInfo)
Object	getResource(ResourceSpec spec, ResourceAllocator alloc, ClientSecurityInfo info) Obtain a transactional resource such as JDBC connection
ResourceHandle	getResourceFromPool(ResourceSpec spec, ResourceAllocator alloc, ClientSecurityInfo info, Transaction tran)
ResourceReferenceDescriptor	getResourceReference(String jndiName, String logicalName)
void	killAllPools()
void	killFreeConnectionsInPools()
void	killPool(PoolInfo poolInfo)
void	lazyEnlist(javax.resource.spi.ManagedConnection mc)
void	putbackBadResourceToPool(ResourceHandle h)
void	putbackDirectToPool(ResourceHandle h, PoolInfo poolInfo)
void	putbackResourceToPool(ResourceHandle h, boolean errorOccurred)
void	reconfigPoolProperties(ConnectorConnectionPool ccp)
void	registerPoolLifeCycleListener(PoolLifeCycle poolListener)
void	resourceAbortOccurred(ResourceHandle res)
void	resourceClosed(ResourceHandle res)
void	resourceErrorOccurred(ResourceHandle res)
void	setSelfManaged(PoolInfo poolInfo, boolean flag)
boolean	switchOnMatching(PoolInfo poolInfo)
void	transactionCompleted(Transaction tran, int status)
void	unregisterPoolLifeCycleListener()

Methods inherited from interface com.sun.appserv.connectors.internal.api.TransactedPoolManager

registerResource, resourceEnlisted, unregisterResource

Field Detail

NO_TRANSACTION

static final int NO_TRANSACTION

See Also:

Constant Field Values

LOCAL_TRANSACTION

static final int LOCAL_TRANSACTION

See Also:

Constant Field Values

XA_TRANSACTION

static final int XA_TRANSACTION

See Also:

Constant Field Values

BASIC_PASSWORD

static final int BASIC_PASSWORD

See Also:

Constant Field Values

KERBV5

static final int KERBV5

See Also:

Constant Field Values

PASSWORD_CREDENTIAL

static final String PASSWORD_CREDENTIAL

See Also:

Constant Field Values

GENERIC_CREDENTIAL

static final String GENERIC_CREDENTIAL

See Also:

Constant Field Values

Method Detail

flushConnectionPool

boolean flushConnectionPool(PoolInfo poolInfo)
                     throws PoolingException

Flush Connection pool by reinitializing the connections established in the pool.

Parameters:

poolInfo -

Throws:

PoolingException

getPoolStatus

PoolStatus getPoolStatus(PoolInfo poolInfo)

getResourceFromPool

ResourceHandle getResourceFromPool(ResourceSpec spec,
                                   ResourceAllocator alloc,
                                   ClientSecurityInfo info,
                                   Transaction tran)
                            throws PoolingException,
                                   javax.resource.spi.RetryableUnavailableException

Throws:

PoolingException

javax.resource.spi.RetryableUnavailableException

createEmptyConnectionPool

void createEmptyConnectionPool(PoolInfo poolInfo,
                               ConnectorConstants.PoolType pt,
                               Hashtable env)
                        throws PoolingException

Throws:

PoolingException

putbackResourceToPool

void putbackResourceToPool(ResourceHandle h,
                           boolean errorOccurred)

putbackBadResourceToPool

void putbackBadResourceToPool(ResourceHandle h)

putbackDirectToPool

void putbackDirectToPool(ResourceHandle h,
                         PoolInfo poolInfo)

resourceClosed

void resourceClosed(ResourceHandle res)

badResourceClosed

void badResourceClosed(ResourceHandle res)

resourceErrorOccurred

void resourceErrorOccurred(ResourceHandle res)

resourceAbortOccurred

void resourceAbortOccurred(ResourceHandle res)

transactionCompleted

void transactionCompleted(Transaction tran,
                          int status)

emptyResourcePool

void emptyResourcePool(ResourceSpec spec)

killPool

void killPool(PoolInfo poolInfo)

reconfigPoolProperties

void reconfigPoolProperties(ConnectorConnectionPool ccp)
                     throws PoolingException

Throws:

PoolingException

switchOnMatching

boolean switchOnMatching(PoolInfo poolInfo)

getResource

Object getResource(ResourceSpec spec,
                   ResourceAllocator alloc,
                   ClientSecurityInfo info)
            throws PoolingException,
                   javax.resource.spi.RetryableUnavailableException

Obtain a transactional resource such as JDBC connection

Parameters:

spec - Specification for the resource

alloc - Allocator for the resource

info - Client security for this request

Returns:

An object that represents a connection to the resource

Throws:

PoolingException - Thrown if some error occurs while obtaining the resource

javax.resource.spi.RetryableUnavailableException

getResourceReference

ResourceReferenceDescriptor getResourceReference(String jndiName,
                                                 String logicalName)

killAllPools

void killAllPools()

killFreeConnectionsInPools

void killFreeConnectionsInPools()

getPool

ResourcePool getPool(PoolInfo poolInfo)

setSelfManaged

void setSelfManaged(PoolInfo poolInfo,
                    boolean flag)

lazyEnlist

void lazyEnlist(javax.resource.spi.ManagedConnection mc)
         throws javax.resource.ResourceException

Throws:

javax.resource.ResourceException

registerPoolLifeCycleListener

void registerPoolLifeCycleListener(PoolLifeCycle poolListener)

unregisterPoolLifeCycleListener

void unregisterPoolLifeCycleListener()