at.chrl.database

Class Transaction

java.lang.Object

at.chrl.database.Transaction

public class Transaction
extends Object

This class allows easy manipulations with transactions, it should be used when critical or synchronized data should be commited to two or more tables. This class allows us to avoid data synchronization problems in db.

Class is not designed to be thread-safe, should be synchronized externally.
Class is not fail-safe, if error happens - exception will be thrown.

Author:

SoulKeeper

Method Summary

Modifier and Type	Method and Description
void	commit() Commits transaction
void	commit(Savepoint rollBackToOnError) Commits transaction.
void	insertUpdate(String sql) Adds Insert / Update Query to the transaction
void	insertUpdate(String sql, IUStH iusth) Adds Insert / Update Query to this transaction.
void	releaseSavepoint(Savepoint savepoint) Releases savepoint of transaction
Savepoint	setSavepoint(String name) Creates new savepoint

Methods inherited from class java.lang.Object

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

Method Detail

insertUpdate

public void insertUpdate(String sql)
                  throws SQLException

Adds Insert / Update Query to the transaction

Parameters:

sql - SQL string

Throws:

SQLException - if something went wrong

insertUpdate

public void insertUpdate(String sql,
                         IUStH iusth)
                  throws SQLException

Adds Insert / Update Query to this transaction. Utilizes IUSth for Batching and Query Editing. MUST MANUALLY EXECUTE QUERY / BATACH IN IUSth (No need to close Statement after execution)

Parameters:

sql - Sql query

iusth - query helper

Throws:

SQLException - if something went wrong

setSavepoint

public Savepoint setSavepoint(String name)
                       throws SQLException

Creates new savepoint

Parameters:

name - name of savepoint

Returns:

created savepoint

Throws:

SQLException - if can't create save point

releaseSavepoint

public void releaseSavepoint(Savepoint savepoint)
                      throws SQLException

Releases savepoint of transaction

Parameters:

savepoint - savepoint to release

Throws:

SQLException - if something went wrong

commit

public void commit()
            throws SQLException

Commits transaction

Throws:

SQLException - if something is wrong with transaction

commit

public void commit(Savepoint rollBackToOnError)
            throws SQLException

Commits transaction. If rollBackToOnError is null - whole transaction will be rolledback

Parameters:

rollBackToOnError - savepoint that should be used to rollback

Throws:

SQLException - if something went wrongF