org.seasar.doma.jdbc.tx

Class LocalTransactionDataSource

java.lang.Object

org.seasar.doma.jdbc.tx.LocalTransactionDataSource

All Implemented Interfaces:

java.sql.Wrapper, javax.sql.CommonDataSource, javax.sql.DataSource

public final class LocalTransactionDataSource
extends java.lang.Object
implements javax.sql.DataSource

A data source for local transactions.

This instance is thread safe.

See Also:

LocalTransaction

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method and Description
java.sql.Connection	getConnection()
java.sql.Connection	getConnection(java.lang.String username, java.lang.String password)
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()
java.io.PrintWriter	getLogWriter()
java.util.logging.Logger	getParentLogger()
boolean	isWrapperFor(java.lang.Class<?> iface)
void	setLoginTimeout(int seconds)
void	setLogWriter(java.io.PrintWriter out)
<T> T	unwrap(java.lang.Class<T> iface)

Methods inherited from class java.lang.Object

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

Constructor Detail

LocalTransactionDataSource

public LocalTransactionDataSource(javax.sql.DataSource dataSource)

Creates an instance.

Parameters:

dataSource - the internal data source

Throws:

DomaNullPointerException - if the dataSource is null

LocalTransactionDataSource

public LocalTransactionDataSource(java.lang.String url,
                                  java.lang.String user,
                                  java.lang.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 Detail

getConnection

public java.sql.Connection getConnection()

Specified by:

getConnection in interface javax.sql.DataSource

Throws:

TransactionNotYetBegunException - if the transaction is not yet begun

See Also:

LocalTransaction

getConnection

public java.sql.Connection getConnection(java.lang.String username,
                                         java.lang.String password)

Specified by:

getConnection in interface javax.sql.DataSource

Throws:

TransactionNotYetBegunException - if the transaction is not yet begun

See Also:

LocalTransaction

getLoginTimeout

public int getLoginTimeout()
                    throws java.sql.SQLException

Specified by:

getLoginTimeout in interface javax.sql.CommonDataSource

Throws:

java.sql.SQLException

getLogWriter

public java.io.PrintWriter getLogWriter()
                                 throws java.sql.SQLException

Specified by:

getLogWriter in interface javax.sql.CommonDataSource

Throws:

java.sql.SQLException

isWrapperFor

public boolean isWrapperFor(java.lang.Class<?> iface)
                     throws java.sql.SQLException

Specified by:

isWrapperFor in interface java.sql.Wrapper

Throws:

java.sql.SQLException

setLoginTimeout

public void setLoginTimeout(int seconds)
                     throws java.sql.SQLException

Specified by:

setLoginTimeout in interface javax.sql.CommonDataSource

Throws:

java.sql.SQLException

setLogWriter

public void setLogWriter(java.io.PrintWriter out)
                  throws java.sql.SQLException

Specified by:

setLogWriter in interface javax.sql.CommonDataSource

Throws:

java.sql.SQLException

unwrap

public <T> T unwrap(java.lang.Class<T> iface)
             throws java.sql.SQLException

Specified by:

unwrap in interface java.sql.Wrapper

Throws:

java.sql.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 java.util.logging.Logger getParentLogger()
                                         throws java.sql.SQLFeatureNotSupportedException

Specified by:

getParentLogger in interface javax.sql.CommonDataSource

Throws:

java.sql.SQLFeatureNotSupportedException