cz.ues.platform.commons.transaction

Class UESTransaction

java.lang.Object

cz.ues.platform.commons.transaction.UESTransaction

public final class UESTransaction
extends java.lang.Object

UESTransaction is a helper class for secure transaction handling. Usage pattern:

   UESTransaction tx = UESTransaction.begin();
   try {
     //...
     // a business logic here
     //...

     // has to be last operation. Marks transaction to be commited.
     tx.prepareCommit();
   } finally {
     // commit transaction. When exception occured and prepareCommit was not called or
     // transaction is marked for rollback, rollback is called instead.
     tx.commit();
   }
 

Since:

UES6-00

Field Summary

Fields

Modifier and Type	Field and Description
private boolean	doCommit Flag if transaction should be commited.
private static java.lang.String	FOO_TX_MANAGER Name of foo transaction manager.
private TransactionContext	txContext Instance of transaction context.
private TransactionManager	txManager Instance of transaction manager.

Constructor Summary

Constructors

Modifier	Constructor and Description
private	UESTransaction() Prepares transaction manager to manage transaction.

Method Summary

Methods

Modifier and Type	Method and Description
static UESTransaction	begin() Starts new transaction.
private void	begin0() Starts new transaction.
void	commit() Finishes the transaction.
static UESTransaction	get() Returns existing transaction or starts new one of transaction does not exist.
private void	get0() Obtains existing transaction or starts new one.
void	prepareCommit() Sets transaction status to COMMIT state.
void	setRollbackOnly() Marks transaction as rollback-only.

Methods inherited from class java.lang.Object

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

Field Detail

FOO_TX_MANAGER

private static final FOO_TX_MANAGER

Name of foo transaction manager.

See Also:

Constant Field Values

txManager

private txManager

Instance of transaction manager.

txContext

private txContext

Instance of transaction context.

doCommit

private doCommit

Flag if transaction should be commited.

Constructor Detail

UESTransaction

private UESTransaction()

Prepares transaction manager to manage transaction.

Since:

UES6-00

Method Detail

begin

public static UESTransaction begin()
throws TransactionRTException

Starts new transaction.

Returns:

New transaction

Throws:

TransactionRTException - In case starting of new transaction fails.

Since:

UES6-00

get

public static UESTransaction get()
throws TransactionRTException

Returns existing transaction or starts new one of transaction does not exist.

Returns:

Existing or new transaction

Throws:

TransactionRTException - In case starting of new transaction fails.

Since:

UES6-00

begin0

private void begin0()
throws TransactionRTException

Starts new transaction.

Throws:

TransactionRTException - In case starting of new transaction fails.

Since:

UES6-00

get0

private void get0()
throws TransactionRTException

Obtains existing transaction or starts new one.

Throws:

TransactionRTException - In case starting of new transaction fails.

Since:

UES6-00

setRollbackOnly

public void setRollbackOnly()

Marks transaction as rollback-only.

Since:

UES6-00

prepareCommit

public void prepareCommit()

Sets transaction status to COMMIT state.

Since:

UES6-00

commit

public void commit()
throws TransactionRTException

Finishes the transaction. When possible transaction will be commited otherwise transaction will be rolled back.

Throws:

TransactionRTException - In case commit (or rollback) of transaction commit fails.

Since:

UES6-00