org.jboss.jca.core.connectionmanager.pool.api

Interface Pool

All Superinterfaces:

org.jboss.jca.core.api.connectionmanager.pool.Pool

All Known Subinterfaces:

PrefillPool

All Known Implementing Classes:

AbstractPrefillPool, OnePool, PoolBySubject

public interface Pool
extends org.jboss.jca.core.api.connectionmanager.pool.Pool

A pool.

Author:

Gurkan Erdogdu, David Jencks, Jesper Pedersen

Method Summary

Methods

Modifier and Type	Method and Description
void	emptyManagedConnectionPool(ManagedConnectionPool pool) Remove the matching managed connection pool if the pool is empty
ConnectionListener	findConnectionListener(javax.resource.spi.ManagedConnection mc) Find a connection listener
ConnectionListener	findConnectionListener(javax.resource.spi.ManagedConnection mc, Object connection) Find a connection listener
Capacity	getCapacity() Get the capacity policy
ConnectionListener	getConnection(Transaction trackByTransaction, Subject subject, javax.resource.spi.ConnectionRequestInfo cri) Get a connection
CoreLogger	getLogger() Get the logger
javax.resource.spi.ManagedConnectionFactory	getManagedConnectionFactory() Retrieve the managed connection factory for this pool.
boolean	isSharable() Is sharable
boolean	isShutdown() Is shutdown
void	returnConnection(ConnectionListener cl, boolean kill) Return a connection
void	setCapacity(Capacity c) Set the capacity policy
void	setConnectionManager(ConnectionManager cm) Set the connection manager
void	setName(String poolName) Sets pool name.
void	shutdown() Shutdown the pool

Methods inherited from interface org.jboss.jca.core.api.connectionmanager.pool.Pool

flush, flush, flush, getName, getStatistics, testConnection, testConnection

Method Detail

setName

void setName(String poolName)

Sets pool name.

Parameters:

poolName - pool name

isSharable

boolean isSharable()

Is sharable

Returns:

The value

getManagedConnectionFactory

javax.resource.spi.ManagedConnectionFactory getManagedConnectionFactory()

Retrieve the managed connection factory for this pool.

Returns:

the managed connection factory

setConnectionManager

void setConnectionManager(ConnectionManager cm)

Set the connection manager

Parameters:

cm - the connection manager

getCapacity

Capacity getCapacity()

Get the capacity policy

Returns:

The value

setCapacity

void setCapacity(Capacity c)

Set the capacity policy

Parameters:

c - The value

getConnection

ConnectionListener getConnection(Transaction trackByTransaction,
                               Subject subject,
                               javax.resource.spi.ConnectionRequestInfo cri)
                                 throws javax.resource.ResourceException

Get a connection

Parameters:

trackByTransaction - for transaction stickiness

subject - the subject for connection

cri - the connection request information

Returns:

a connection event listener wrapping the connection

Throws:

javax.resource.ResourceException - for any error

findConnectionListener

ConnectionListener findConnectionListener(javax.resource.spi.ManagedConnection mc)

Find a connection listener

Parameters:

mc - The managed connection

Returns:

The connection listener

findConnectionListener

ConnectionListener findConnectionListener(javax.resource.spi.ManagedConnection mc,
                                        Object connection)

Find a connection listener

Parameters:

mc - The managed connection

connection - The connection

Returns:

The connection listener

returnConnection

void returnConnection(ConnectionListener cl,
                    boolean kill)
                      throws javax.resource.ResourceException

Return a connection

Parameters:

cl - the connection event listener wrapping the connection

kill - whether to destroy the managed connection

Throws:

javax.resource.ResourceException - for any error

isShutdown

boolean isShutdown()

Is shutdown

Returns:

The value

shutdown

void shutdown()

Shutdown the pool

emptyManagedConnectionPool

void emptyManagedConnectionPool(ManagedConnectionPool pool)

Remove the matching managed connection pool if the pool is empty

Parameters:

pool - The pool

getLogger

CoreLogger getLogger()

Get the logger

Returns:

The value