com.atomikos.jdbc

Class AtomikosNonXADataSourceBean

java.lang.Object

com.atomikos.jdbc.internal.AbstractDataSourceBean

com.atomikos.jdbc.AtomikosNonXADataSourceBean

All Implemented Interfaces:

ConnectionPoolProperties, java.io.Serializable, java.sql.Wrapper, javax.naming.Referenceable, javax.sql.CommonDataSource, javax.sql.DataSource

Direct Known Subclasses:

AtomikosNonXADataSourceBean

public class AtomikosNonXADataSourceBean
extends AbstractDataSourceBean

A Bean class for DataSource access to non-XA JDBC implementations. Instances are JTA transaction-aware and can rollback the work done over multiple connections (provided that all work was done in one and the same thread).

See Also:

Serialized Form

Field Summary

Fields inherited from interface com.atomikos.datasource.pool.ConnectionPoolProperties

DEFAULT_BORROW_CONNECTION_TIMEOUT, DEFAULT_ISOLATION_LEVEL_UNSET, DEFAULT_MAINTENANCE_INTERVAL, DEFAULT_MAX_IDLE_TIME, DEFAULT_MAX_LIFETIME, DEFAULT_POOL_SIZE, DEFAULT_REAP_TIMEOUT

Constructor Summary

Constructors

Constructor and Description
AtomikosNonXADataSourceBean()

Method Summary

Modifier and Type	Method and Description
protected void	doClose()
protected ConnectionFactory<java.sql.Connection>	doInit()
java.sql.Connection	getConnection()
java.lang.String	getDriverClassName()
boolean	getIgnoreJtaTransactions()
boolean	getLocalTransactionMode() Tests if JTA transactions are ignored or not.
java.lang.String	getPassword()
boolean	getReadOnly()
java.lang.String	getUrl() Gets the URL to connect.
java.lang.String	getUser()
protected boolean	isAssignableFromWrappedVendorClass(java.lang.Class<?> iface)
void	setDriverClassName(java.lang.String string) Sets the driver class name to be used by the DriverManager.
void	setIgnoreJtaTransactions(boolean ignoreJtaTransactions) Should JTA transactions be ignored completely or not? Optional, defaults to false.
void	setLocalTransactionMode(boolean value) Should JTA transactions be ignored? Optional - most use cases should not change the default setting.
void	setPassword(java.lang.String string) Sets the password to use.
void	setReadOnly(boolean readOnly) Marks this datasource as being used for read-only work.
void	setUrl(java.lang.String url) Sets the URL to use for getting connections.
void	setUser(java.lang.String string) Set the user name to get connections with.
java.lang.String	toString()
protected java.lang.Object	unwrapVendorInstance()

Methods inherited from class com.atomikos.jdbc.internal.AbstractDataSourceBean

close, getBorrowConnectionTimeout, getConcurrentConnectionValidation, getConnection, getDefaultIsolationLevel, getLoginTimeout, getLogWriter, getMaintenanceInterval, getMaxIdleTime, getMaxLifetime, getMaxPoolSize, getMinPoolSize, getParentLogger, getReapTimeout, getReference, getTestQuery, getUniqueResourceName, init, isWrapperFor, poolAvailableSize, poolTotalSize, refreshPool, setBorrowConnectionTimeout, setConcurrentConnectionValidation, setDefaultIsolationLevel, setLoginTimeout, setLogWriter, setMaintenanceInterval, setMaxIdleTime, setMaxLifetime, setMaxPoolSize, setMinPoolSize, setPoolSize, setReapTimeout, setTestQuery, setUniqueResourceName, throwAtomikosSQLException, unwrap

Methods inherited from class java.lang.Object

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

Constructor Detail

AtomikosNonXADataSourceBean

public AtomikosNonXADataSourceBean()

Method Detail

setUrl

public void setUrl(java.lang.String url)

Sets the URL to use for getting connections. Required.

Parameters:

url -

getUrl

public java.lang.String getUrl()

Gets the URL to connect.

setReadOnly

public void setReadOnly(boolean readOnly)

Marks this datasource as being used for read-only work. Optional. Setting this to true will avoid warnings/errors on 2-phase commit. ReadOnly mode is intended to avoid XA configuration of databases where no updates are being done.

Parameters:

readOnly - Defaults to false.

getReadOnly

public boolean getReadOnly()

Returns:

Whether or not this datasource is marked as readOnly.

getPassword

public java.lang.String getPassword()

Returns:

The password.

setPassword

public void setPassword(java.lang.String string)

Sets the password to use.

Parameters:

string -

setUser

public void setUser(java.lang.String string)

Set the user name to get connections with.

Parameters:

string -

getUser

public java.lang.String getUser()

Returns:

The URL to connect with.

getDriverClassName

public java.lang.String getDriverClassName()

Returns:

The DriverManager class name.

setDriverClassName

public void setDriverClassName(java.lang.String string)

Sets the driver class name to be used by the DriverManager. Required.

Parameters:

string -

doClose

protected void doClose()

Specified by:

doClose in class AbstractDataSourceBean

doInit

protected ConnectionFactory<java.sql.Connection> doInit()
                                                 throws java.lang.Exception

Specified by:

doInit in class AbstractDataSourceBean

Throws:

java.lang.Exception

getConnection

public java.sql.Connection getConnection()
                                  throws java.sql.SQLException

Specified by:

getConnection in interface javax.sql.DataSource

Overrides:

getConnection in class AbstractDataSourceBean

Throws:

java.sql.SQLException

setLocalTransactionMode

public void setLocalTransactionMode(boolean value)

Should JTA transactions be ignored? Optional - most use cases should not change the default setting. If set, then this instance will act like a regular, non-JTA JDBC datasource.

Parameters:

value - Defaults to false.

getLocalTransactionMode

public boolean getLocalTransactionMode()

Tests if JTA transactions are ignored or not.

Specified by:

getLocalTransactionMode in interface ConnectionPoolProperties

Overrides:

getLocalTransactionMode in class AbstractDataSourceBean

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

isAssignableFromWrappedVendorClass

protected boolean isAssignableFromWrappedVendorClass(java.lang.Class<?> iface)

Specified by:

isAssignableFromWrappedVendorClass in class AbstractDataSourceBean

unwrapVendorInstance

protected java.lang.Object unwrapVendorInstance()

Specified by:

unwrapVendorInstance in class AbstractDataSourceBean

setIgnoreJtaTransactions

public void setIgnoreJtaTransactions(boolean ignoreJtaTransactions)

Should JTA transactions be ignored completely or not? Optional, defaults to false.

Parameters:

ignoreJtaTransactions -

getIgnoreJtaTransactions

public boolean getIgnoreJtaTransactions()