org.enhydra.jdbc.standard

Class StandardXADataSource

java.lang.Object

org.enhydra.jdbc.util.JdbcUtil

org.enhydra.jdbc.core.CoreDataSource

org.enhydra.jdbc.standard.StandardDataSource

org.enhydra.jdbc.standard.StandardConnectionPoolDataSource

org.enhydra.jdbc.standard.StandardXADataSource

All Implemented Interfaces:

Serializable, Wrapper, Referenceable, ObjectFactory, CommonDataSource, ConnectionPoolDataSource, DataSource, XADataSource

Direct Known Subclasses:

IdbXADataSource, InformixXADataSource, OracleXADataSource, SybaseXADataSource

public class StandardXADataSource
extends StandardConnectionPoolDataSource
implements XADataSource

Data source for creating StandardXAConnections.

See Also:

Serialized Form

Field Summary

Fields

Modifier and Type	Field and Description
int	connectionCount
long	deadLockMaxWait
long	deadLockRetryWait
static long	DEFAULT_DEADLOCKMAXWAIT
static int	DEFAULT_DEADLOCKRETRYWAIT
static int	DEFAULT_MAX_CON
static int	DEFAULT_MIN_CON
int	maxCon
int	minCon
TransactionManager	transactionManager

Fields inherited from class org.enhydra.jdbc.standard.StandardConnectionPoolDataSource

DEFAULT_PREPAREDSTMTCACHESIZE

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

logWriter, password, user

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

log

Constructor Summary

Constructors

Constructor and Description
StandardXADataSource() Constructor

Method Summary

Modifier and Type	Method and Description
void	closeFreeConnection()
void	dump()
void	freeConnection(Xid id, boolean placeAtStart) Frees a connection to make it eligible for reuse.
int	getAllConnections()
int	getConnectionCount()
long	getDeadLockMaxWait()
long	getDeadLockRetryWait()
StandardXAStatefulConnection	getFreeConnection() Returns a connection from the free list, removing it in the process.
int	getMaxCon()
int	getMinCon()
TransactionManager	getTransactionManager()
XAConnection	getXAConnection() Creates an XA connection using the default username and password.
XAConnection	getXAConnection(String user, String password) Creates an XA connection using the supplied username and password.
Hashtable	getXidConnections()
int	getXidCount() Returns the number of connections that are either prepared or heuristically completed.
void	processToWait()
void	setDeadLockMaxWait(long deadLock)
void	setDeadLockRetryWait(long deadLockRetryWait)
void	setDriverName(String driverName) set the name of the jdbc driver
void	setMaxCon(int max)
void	setMinCon(int min)
void	setPassword(String password)
void	setTransactionManager(TransactionManager tm)
void	setUrl(String url) set the database url
void	setUser(String user)
String	toString()

Methods inherited from class org.enhydra.jdbc.standard.StandardConnectionPoolDataSource

getMasterPrepStmtCache, getPooledConnection, getPooledConnection, getPreparedStmtCacheSize, setPreparedStmtCacheSize

Methods inherited from class org.enhydra.jdbc.standard.StandardDataSource

equals, getConnection, getConnection, getDriverName, getObjectInstance, getParentLogger, getReference, getTransactionIsolation, getUrl, hashCode, isWrapperFor, setTransactionIsolation, unwrap

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

getDescription, getLoginTimeout, getLogWriter, getPassword, getThreadFactory, getUser, isDebug, isVerbose, setDebug, setDescription, setLoginTimeout, setLogWriter, setThreadFactory, setVerbose, shutdown

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

setLogger

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface javax.sql.CommonDataSource

getLoginTimeout, getLogWriter, getParentLogger, setLoginTimeout, setLogWriter

Field Detail

minCon

public int minCon

maxCon

public int maxCon

deadLockMaxWait

public long deadLockMaxWait

connectionCount

public int connectionCount

deadLockRetryWait

public long deadLockRetryWait

transactionManager

public transient TransactionManager transactionManager

DEFAULT_MIN_CON

public static final int DEFAULT_MIN_CON

See Also:

Constant Field Values

DEFAULT_MAX_CON

public static final int DEFAULT_MAX_CON

See Also:

Constant Field Values

DEFAULT_DEADLOCKMAXWAIT

public static final long DEFAULT_DEADLOCKMAXWAIT

See Also:

Constant Field Values

DEFAULT_DEADLOCKRETRYWAIT

public static final int DEFAULT_DEADLOCKRETRYWAIT

See Also:

Constant Field Values

Constructor Detail

StandardXADataSource

public StandardXADataSource()

Constructor

Method Detail

getConnectionCount

public int getConnectionCount()

getXidConnections

public Hashtable getXidConnections()

getXAConnection

public XAConnection getXAConnection()
                             throws SQLException

Creates an XA connection using the default username and password.

Specified by:

getXAConnection in interface XADataSource

Throws:

SQLException

getXAConnection

public XAConnection getXAConnection(String user,
                                    String password)
                             throws SQLException

Creates an XA connection using the supplied username and password.

Specified by:

getXAConnection in interface XADataSource

Throws:

SQLException

setTransactionManager

public void setTransactionManager(TransactionManager tm)

getTransactionManager

public TransactionManager getTransactionManager()

setUser

public void setUser(String user)

Overrides:

setUser in class CoreDataSource

setPassword

public void setPassword(String password)

Overrides:

setPassword in class CoreDataSource

setUrl

public void setUrl(String url)

Description copied from class: StandardDataSource

set the database url

Overrides:

setUrl in class StandardDataSource

Parameters:

url - the string representation of the database url

setDriverName

public void setDriverName(String driverName)
                   throws SQLException

Description copied from class: StandardDataSource

set the name of the jdbc driver

Overrides:

setDriverName in class StandardDataSource

Parameters:

driverName - the string representation of the jdbc driver name

Throws:

SQLException

getXidCount

public int getXidCount()

Returns the number of connections that are either prepared or heuristically completed.

freeConnection

public void freeConnection(Xid id,
                           boolean placeAtStart)

Frees a connection to make it eligible for reuse. The free list is normally a last in, first out list (LIFO). This is efficient. However, timed out connections are nice to hang onto for error reporting, so they can be placed at the start. This is less efficient, but hopefully is a rare occurence. Here, no need to verify the number of connections, we remove an object from the xidConnections to put it in th freeConnections

getFreeConnection

public StandardXAStatefulConnection getFreeConnection()
                                               throws SQLException

Returns a connection from the free list, removing it in the process. If none area available then a new connection is created.

Throws:

SQLException

closeFreeConnection

public void closeFreeConnection()

setMinCon

public void setMinCon(int min)

setMaxCon

public void setMaxCon(int max)

setDeadLockMaxWait

public void setDeadLockMaxWait(long deadLock)

getMinCon

public int getMinCon()

getMaxCon

public int getMaxCon()

getDeadLockMaxWait

public long getDeadLockMaxWait()

getAllConnections

public int getAllConnections()

processToWait

public void processToWait()
                   throws Exception

Throws:

Exception

dump

public void dump()

setDeadLockRetryWait

public void setDeadLockRetryWait(long deadLockRetryWait)

getDeadLockRetryWait

public long getDeadLockRetryWait()

toString

public String toString()

Overrides:

toString in class StandardConnectionPoolDataSource