Module org.seasar.doma.core

Package org.seasar.doma.jdbc.tx

Class LocalTransactionDataSource

java.lang.Object

org.seasar.doma.jdbc.tx.LocalTransactionDataSource

All Implemented Interfaces:

Wrapper, CommonDataSource, DataSource

public final class LocalTransactionDataSource
extends Object
implements DataSource

A data source for local transactions.

This instance is thread safe.

See Also:

• LocalTransaction

Constructor Summary

Constructors

Constructor	Description
LocalTransactionDataSource(String url, String user, String password)	Creates an instance with information about the connection.
LocalTransactionDataSource(DataSource dataSource)	Creates an instance.

Method Summary

Modifier and Type	Method	Description
Connection	getConnection()	Returns a connection.
Connection	getConnection(String username, String password)	Returns a connection.
KeepAliveLocalTransaction	getKeepAliveLocalTransaction(JdbcLogger jdbcLogger)	Returns a keep alive local transaction.
KeepAliveLocalTransaction	getKeepAliveLocalTransaction(JdbcLogger jdbcLogger, TransactionIsolationLevel transactionIsolationLevel)	Returns a keep alive local transaction with the specified transaction level.
LocalTransaction	getLocalTransaction(JdbcLogger jdbcLogger)	Returns a local transaction.
LocalTransaction	getLocalTransaction(JdbcLogger jdbcLogger, TransactionIsolationLevel transactionIsolationLevel)	Returns a local transaction with the specified transaction level.
int	getLoginTimeout()
PrintWriter	getLogWriter()
Logger	getParentLogger()
boolean	isWrapperFor(Class<?> iface)
void	setLoginTimeout(int seconds)
void	setLogWriter(PrintWriter out)
<T> T	unwrap(Class<T> iface)

Methods inherited from class java.lang.Object

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

Methods inherited from interface javax.sql.CommonDataSource

createShardingKeyBuilder

Methods inherited from interface javax.sql.DataSource

createConnectionBuilder

Constructor Details

LocalTransactionDataSource

public LocalTransactionDataSource(DataSource dataSource)

Creates an instance.

Parameters:

dataSource - the internal data source

Throws:

DomaNullPointerException - if the dataSource is null

LocalTransactionDataSource

public LocalTransactionDataSource(String url,
 String user,
 String password)

Creates an instance with information about the connection.

Parameters:

url - a database url

user - the database user

password - the user's password

Throws:

DomaNullPointerException - if the url is null

Method Details

getConnection

public Connection getConnection()

Returns a connection.

If a transaction has started, it returns the connection under transaction management; if not, it returns the connection provided by the internal data source.

Specified by:

getConnection in interface DataSource

Returns:

the connection

See Also:

• LocalTransaction

getConnection

public Connection getConnection(String username,
 String password)

Returns a connection.

If a transaction has started, it returns the connection under transaction management; if not, it returns the connection provided by the internal data source.

Specified by:

getConnection in interface DataSource

Returns:

the connection

See Also:

• LocalTransaction

getLoginTimeout

public int getLoginTimeout()
                    throws SQLException

Specified by:

getLoginTimeout in interface CommonDataSource

Specified by:

getLoginTimeout in interface DataSource

Throws:

SQLException

getLogWriter

public PrintWriter getLogWriter()
                         throws SQLException

Specified by:

getLogWriter in interface CommonDataSource

Specified by:

getLogWriter in interface DataSource

Throws:

SQLException

isWrapperFor

public boolean isWrapperFor(Class<?> iface)
                     throws SQLException

Specified by:

isWrapperFor in interface Wrapper

Throws:

SQLException

setLoginTimeout

public void setLoginTimeout(int seconds)
                     throws SQLException

Specified by:

setLoginTimeout in interface CommonDataSource

Specified by:

setLoginTimeout in interface DataSource

Throws:

SQLException

setLogWriter

public void setLogWriter(PrintWriter out)
                  throws SQLException

Specified by:

setLogWriter in interface CommonDataSource

Specified by:

setLogWriter in interface DataSource

Throws:

SQLException

unwrap

public <T> T unwrap(Class<T> iface)
             throws SQLException

Specified by:

unwrap in interface Wrapper

Throws:

SQLException

getLocalTransaction

public LocalTransaction getLocalTransaction(JdbcLogger jdbcLogger)

Returns a local transaction.

Parameters:

jdbcLogger - the logger

Returns:

the transaction

Throws:

DomaNullPointerException - if the jdbcLogger is null

getLocalTransaction

public LocalTransaction getLocalTransaction(JdbcLogger jdbcLogger,
 TransactionIsolationLevel transactionIsolationLevel)

Returns a local transaction with the specified transaction level.

Parameters:

jdbcLogger - the logger

transactionIsolationLevel - the transaction isolation level

Returns:

the transaction

Throws:

DomaNullPointerException - if any arguments are null

getKeepAliveLocalTransaction

public KeepAliveLocalTransaction getKeepAliveLocalTransaction(JdbcLogger jdbcLogger)

Returns a keep alive local transaction.

Parameters:

jdbcLogger - the logger

Returns:

the transaction

Throws:

DomaNullPointerException - if the jdbcLogger is null

getKeepAliveLocalTransaction

public KeepAliveLocalTransaction getKeepAliveLocalTransaction(JdbcLogger jdbcLogger,
 TransactionIsolationLevel transactionIsolationLevel)

Returns a keep alive local transaction with the specified transaction level.

Parameters:

jdbcLogger - the logger

transactionIsolationLevel - the isolation level

Returns:

the transaction

Throws:

DomaNullPointerException - if any arguments are null

getParentLogger

public Logger getParentLogger()
                       throws SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface CommonDataSource

Throws:

SQLFeatureNotSupportedException