org.compiere.util
Class Trx

java.lang.Object
  org.compiere.util.Trx

All Implemented Interfaces:

VetoableChangeListener, EventListener

public class Trx
extends Object
implements VetoableChangeListener

Transaction Management. - Create new Transaction by Trx.get(name); - ..transactions.. - commit(); ---- start(); ---- commit(); - close();

Version:

$Id$

Author:

Jorg Janke

Method Summary

boolean	close() End Transaction and Close Connection
boolean	commit() Release savepoint
static String	createTrxName() Create unique Transaction Name
static String	createTrxName(String prefix) Create unique Transaction Name
static Trx	get(String trxName, boolean createNewWhenNotFoundInCache) Get Transaction
Connection	getConnection() Get Connection
Savepoint	getSavepoint() Get Savepoint
String	getTrxName() Get Name
boolean	isActive() Transaction is Active
boolean	rollback() Rollback
boolean	start() Start Trx
String	toString() String Representation
void	vetoableChange(PropertyChangeEvent evt) Vetoable Change.

Methods inherited from class java.lang.Object

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

Method Detail

get

public static Trx get(String trxName,
                      boolean createNewWhenNotFoundInCache)

Get Transaction

Parameters:

trxName - trx name

createNewWhenNotFoundInCache - if false, null is returned if not found if true, only create a new Trx when trxName is not found in cache

Returns:

Transaction or null

createTrxName

public static String createTrxName(String prefix)

Create unique Transaction Name

Parameters:

prefix - optional prefix

Returns:

unique name

createTrxName

public static String createTrxName()

Create unique Transaction Name

Returns:

unique name

getConnection

public Connection getConnection()

Get Connection

Returns:

connection

getTrxName

public String getTrxName()

Get Name

Returns:

name

start

public boolean start()

Start Trx

Returns:

true if trx started

getSavepoint

public Savepoint getSavepoint()

Get Savepoint

Returns:

savepoint or null

isActive

public boolean isActive()

Transaction is Active

Returns:

true if transaction active

rollback

public boolean rollback()

Rollback

Returns:

true if success

commit

public boolean commit()

Release savepoint

Returns:

true if released public boolean release() { if (m_connection == null) return false; m_active = false; if (m_savepoint == null) return true; try { getConnection().releaseSavepoint(m_savepoint); log.fine("release **** " + getName()); m_savepoint = null; } catch (SQLException e) { log.log(Level.SEVERE, "release ****", e); m_savepoint = null; return false; } return true; } // release /** Commit

close

public boolean close()

End Transaction and Close Connection

Returns:

true if success

toString

public String toString()

String Representation

Overrides:

toString in class Object

Returns:

info

vetoableChange

public void vetoableChange(PropertyChangeEvent evt)
                    throws PropertyVetoException

Vetoable Change. Called from CCache to close connections

Specified by:

vetoableChange in interface VetoableChangeListener

Parameters:

evt - event

Throws:

PropertyVetoException