org.seasar.doma.jdbc.tx

Class KeepAliveLocalTransaction

java.lang.Object

org.seasar.doma.jdbc.tx.LocalTransaction

org.seasar.doma.jdbc.tx.KeepAliveLocalTransaction

public class KeepAliveLocalTransaction
extends LocalTransaction

A local transaction that keeps a JDBC connection open until the transaction is explicitly destroyed.

But the connection is closed, if any exceptions are thrown.

This instance is thread safe.

 KeepAliveLocalTransaction tx = DbConfig.singleton().getKeepAliveLocalTransaction();
 tx.init();
 try {
     try {
         tx.begin();
         Employee employee = dao.selectById(1);
         employee.setName("SMITH");
         employee.setJobType(JobType.PRESIDENT);
         dao.update(employee);
         tx.commit();
     } finally {
         tx.rollback();
     }
     try {
         tx.begin();
         Employee employee = dao.selectById(2);
         employee.setName("foo");
         employee.setJobType(JobType.SALESMAN);
         dao.update(employee);
         tx.commit();
     } finally {
         tx.rollback();
     }
 } finally {
     tx.destroy();
 }
 

Field Summary

Fields inherited from class org.seasar.doma.jdbc.tx.LocalTransaction

className, dataSource, defaultTransactionIsolationLevel, jdbcLogger, localTxContextHolder

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	KeepAliveLocalTransaction(javax.sql.DataSource dataSource, java.lang.ThreadLocal<LocalTransactionContext> localTxContextHolder, JdbcLogger jdbcLogger) Creates an instance.
protected	KeepAliveLocalTransaction(javax.sql.DataSource dataSource, java.lang.ThreadLocal<LocalTransactionContext> localTxContextHolder, JdbcLogger jdbcLogger, TransactionIsolationLevel defaultTransactionIsolationLevel) Creates an instance with the specified transaction isolation level.

Method Summary

Modifier and Type	Method and Description
void	destroy() Destroy the transaction context.
protected void	endInternal(LocalTransactionContext context, java.lang.String callerMethodName) Ends the transaction, but does not close the JDBC connection.
protected LocalTransactionContext	getLocalTransactionContext()
void	init() Initializes a transaction context.
protected boolean	isActiveInternal(LocalTransactionContext context)

Methods inherited from class org.seasar.doma.jdbc.tx.LocalTransaction

begin, begin, beginInternal, closeConnection, commit, end, hasSavepoint, isActive, isRollbackOnly, release, releaseSavepoint, resume, rollback, rollback, rollbackInternal, setRollbackOnly, setSavepoint, suspend, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

KeepAliveLocalTransaction

protected KeepAliveLocalTransaction(javax.sql.DataSource dataSource,
                                    java.lang.ThreadLocal<LocalTransactionContext> localTxContextHolder,
                                    JdbcLogger jdbcLogger)

Creates an instance.

Parameters:

dataSource - the data source

localTxContextHolder - the holder of the transaction context

jdbcLogger - the logger

KeepAliveLocalTransaction

protected KeepAliveLocalTransaction(javax.sql.DataSource dataSource,
                                    java.lang.ThreadLocal<LocalTransactionContext> localTxContextHolder,
                                    JdbcLogger jdbcLogger,
                                    TransactionIsolationLevel defaultTransactionIsolationLevel)

Creates an instance with the specified transaction isolation level.

Parameters:

dataSource - the data source

localTxContextHolder - the holder of the transaction context

jdbcLogger - the logger

defaultTransactionIsolationLevel - the default transaction isolation level

Method Detail

init

public void init()

Initializes a transaction context.

This method establishes a JDBC connection.

If you invoke LocalTransaction.begin() before invoking this method, the LocalTransaction.begin() method establishes a JDBC connection.

Throws:

JdbcException - if a JDBC related error occurs

getLocalTransactionContext

protected LocalTransactionContext getLocalTransactionContext()

Overrides:

getLocalTransactionContext in class LocalTransaction

destroy

public void destroy()

Destroy the transaction context.

This method closes the JDBC connection.

This method does not throw any exceptions.

endInternal

protected void endInternal(LocalTransactionContext context,
                           java.lang.String callerMethodName)

Ends the transaction, but does not close the JDBC connection.

Overrides:

endInternal in class LocalTransaction

isActiveInternal

protected boolean isActiveInternal(LocalTransactionContext context)

Overrides:

isActiveInternal in class LocalTransaction