org.enhydra.jdbc.pool
Class StandardXAPoolDataSource

java.lang.Object
  org.enhydra.jdbc.util.JdbcUtil
      org.enhydra.jdbc.core.CoreDataSource
          org.enhydra.jdbc.pool.StandardPoolDataSource
              org.enhydra.jdbc.pool.StandardXAPoolDataSource

All Implemented Interfaces:

Serializable, Wrapper, EventListener, Referenceable, ObjectFactory, CommonDataSource, ConnectionEventListener, DataSource, PoolHelper

public class StandardXAPoolDataSource
extends StandardPoolDataSource

StandardXAPoolDataSource class allows to make some operations on XAConnection. It implements PoolHelper for the 3 methods :

create : create an XAConnection

create(user,password) : create a PooledConnection with an other user/password

testThisObject : check if the object is still valid

checkThisObject : check if the object is closed

expire : kill the object

See Also:

Serialized Form

Field Summary

org.apache.commons.logging.Log	glog
TransactionManager	transactionManager
String	transactionManagerName
XADataSource	xads

Fields inherited from class org.enhydra.jdbc.pool.StandardPoolDataSource

cpds, dataSourceName, ictx, jdbcTestStmt, onOff, pool

Fields inherited from class org.enhydra.jdbc.core.CoreDataSource

logWriter, password, user

Fields inherited from class org.enhydra.jdbc.util.JdbcUtil

log

Constructor Summary

StandardXAPoolDataSource()
Constructor

StandardXAPoolDataSource(int initSize)
Constructor

StandardXAPoolDataSource(StandardXADataSource ds)
Constructor

StandardXAPoolDataSource(StandardXADataSource ds, int initSize)
Constructor

Method Summary

void	connectionClosed(ConnectionEvent event) Invoked when the application calls close() on its representation of the connection
GenerationObject	create(String _user, String _password)
XADataSource	getDataSource() Getter for property dataSource.
Object	getObjectInstance(Object refObj, Name name, Context nameCtx, Hashtable env) Methods inherited from ObjectFactory
Reference	getReference() Retrieves the Reference of this object.
void	setDataSource(XADataSource dataSource) Setter for property dataSource.
void	setTransactionManager(TransactionManager tm)
void	setTransactionManagerName(String tmName)
boolean	testThisObject(Object o) This method tests if a connection is valid or not.
String	toString()

Methods inherited from class org.enhydra.jdbc.pool.StandardPoolDataSource

checkThisObject, connectionErrorOccurred, create, expire, fullRemoveLockedObject, getCheckLevelObject, getConnection, getConnection, getDataSourceName, getDeadLockMaxWait, getDeadLockRetryWait, getGeneration, getJdbcTestStmt, getLifeTime, getLockedObjectCount, getLogWriter, getMaxLifeTime, getMaxSize, getMinSize, getPool, getSleepTime, getUnlockedObjectCount, getUsedPool, isGC, removeUnlockedObject, setCheckLevelObject, setDataSourceName, setDeadLockMaxWait, setDeadLockRetryWait, setDebug, setGC, setGeneration, setJdbcTestStmt, setLifeTime, setLogWriter, setMaxLifeTime, setMaxSize, setMinSize, setSleepTime, setThreadFactory, shutdown, stopPool

Methods inherited from class org.enhydra.jdbc.core.CoreDataSource

getDescription, getLoginTimeout, getPassword, getThreadFactory, getUser, isDebug, isVerbose, setDescription, setLoginTimeout, setPassword, setUser, setVerbose

Methods inherited from class org.enhydra.jdbc.util.JdbcUtil

setLogger

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.sql.CommonDataSource

getLoginTimeout, setLoginTimeout

Methods inherited from interface java.sql.Wrapper

isWrapperFor, unwrap

Field Detail

xads

public XADataSource xads

transactionManager

public TransactionManager transactionManager

transactionManagerName

public String transactionManagerName

glog

public org.apache.commons.logging.Log glog

Constructor Detail

StandardXAPoolDataSource

public StandardXAPoolDataSource()

Constructor

StandardXAPoolDataSource

public StandardXAPoolDataSource(int initSize)

Constructor

StandardXAPoolDataSource

public StandardXAPoolDataSource(StandardXADataSource ds)

Constructor

StandardXAPoolDataSource

public StandardXAPoolDataSource(StandardXADataSource ds,
                                int initSize)

Constructor

Method Detail

setTransactionManager

public void setTransactionManager(TransactionManager tm)

connectionClosed

public void connectionClosed(ConnectionEvent event)

Invoked when the application calls close() on its representation of the connection

Specified by:

connectionClosed in interface ConnectionEventListener

Overrides:

connectionClosed in class StandardPoolDataSource

create

public GenerationObject create(String _user,
                               String _password)
                        throws SQLException

Specified by:

create in interface PoolHelper

Overrides:

create in class StandardPoolDataSource

Throws:

SQLException

getReference

public Reference getReference()
                       throws NamingException

Retrieves the Reference of this object. Used at binding time by JNDI to build a reference on this object.

Specified by:

getReference in interface Referenceable

Overrides:

getReference in class StandardPoolDataSource

Returns:

The non-null Reference of this object.

Throws:

NamingException - If a naming exception was encountered while retrieving the reference.

getObjectInstance

public Object getObjectInstance(Object refObj,
                                Name name,
                                Context nameCtx,
                                Hashtable env)
                         throws Exception

Description copied from class: CoreDataSource

Methods inherited from ObjectFactory

Specified by:

getObjectInstance in interface ObjectFactory

Overrides:

getObjectInstance in class StandardPoolDataSource

Throws:

Exception

getDataSource

public XADataSource getDataSource()

Getter for property dataSource.

Returns:

Value of property dataSource.

setDataSource

public void setDataSource(XADataSource dataSource)

Setter for property dataSource.

Parameters:

dataSource - New value of property dataSource.

toString

public String toString()

Specified by:

toString in interface PoolHelper

Overrides:

toString in class StandardPoolDataSource

testThisObject

public boolean testThisObject(Object o)

This method tests if a connection is valid or not. It overrides the method in StandardPoolDataSource to take into account global transactions: if global transaction is in progress - suspend it so that connection testing happens ouside of transaction. If connection testing fails - it will not affect transaction and next good connection can join the transaction

Specified by:

testThisObject in interface PoolHelper

Overrides:

testThisObject in class StandardPoolDataSource

setTransactionManagerName

public void setTransactionManagerName(String tmName)