org.mmbase.bridge.implementation
Class BasicTransaction

java.lang.Object
  org.mmbase.bridge.implementation.BasicCloud
      org.mmbase.bridge.implementation.BasicTransaction

All Implemented Interfaces:

java.lang.Cloneable, Cloud, java.lang.Comparable, SizeMeasurable, Transaction

public class BasicTransaction

extends BasicCloud

implements Transaction

The absic implementation for a Transaction cLoud. A Transaction cloud is a cloud which buffers allc hanegs made to nodes - which means that chanegs are committed only if you commit the transaction itself. This mechanism allows you to rollback changes if something goes wrong.

Version:

$Id: BasicTransaction.java,v 1.15 2003/12/17 09:16:44 michiel Exp $

Author:

Pierre van Rooden

Field Summary

protected java.lang.String	transactionContext The id of the transaction for use with the transaction manager.
protected java.lang.String	transactionName The name of the transaction as used by the user.

Fields inherited from class org.mmbase.bridge.implementation.BasicCloud

account, description, name, nodeManagerCache, parentCloud, transactions, userContext

Method Summary

void	cancel() Cancels this transaction.
boolean	commit() Commits this transaction.
protected void	finalize() If this Transaction is scheduled to be garbage collected, the transaction is canceled and cleaned up.

Methods inherited from class org.mmbase.bridge.implementation.BasicCloud

compareTo, createAggregatedQuery, createNodeQuery, createQuery, createTransaction, createTransaction, createTransaction, equals, getByteSize, getByteSize, getCloudContext, getClusterNodes, getDescription, getLastStepList, getList, getList, getLocale, getName, getNode, getNode, getNodeByAlias, getNodeManager, getNodeManager, getNodeManagers, getRelation, getRelation, getRelationManager, getRelationManager, getRelationManager, getRelationManager, getRelationManagers, getRelationManagers, getRelationManagers, getResultNodeList, getSecureList, getTransaction, getUser, hasNode, hasNode, hasNodeManager, hasRelation, hasRelation, hasRelationManager, hasRelationManager, hasRelationManager, hasRole, mayRead, mayRead, setLocale

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.mmbase.bridge.Cloud

createAggregatedQuery, createNodeQuery, createQuery, createTransaction, createTransaction, createTransaction, getCloudContext, getDescription, getList, getList, getLocale, getName, getNode, getNode, getNodeByAlias, getNodeManager, getNodeManager, getNodeManagers, getRelation, getRelation, getRelationManager, getRelationManager, getRelationManager, getRelationManager, getRelationManagers, getRelationManagers, getRelationManagers, getTransaction, getUser, hasNode, hasNode, hasNodeManager, hasRelation, hasRelation, hasRelationManager, hasRelationManager, hasRelationManager, hasRole, mayRead, mayRead, setLocale

Field Detail

transactionContext

protected java.lang.String transactionContext

The id of the transaction for use with the transaction manager.

transactionName

protected java.lang.String transactionName

The name of the transaction as used by the user.

Method Detail

commit

public boolean commit()

Description copied from interface: Transaction

Commits this transaction. This has no effect if the transaction itself was 'nested' in another transaction. In that case, nothing happens until the 'outer' transaction commits. This routine also removes the transaction as an 'active' transaction (it cannot be opened again).

Specified by:

commit in interface Transaction

Returns:

true if the commit succeeded, false otherwise

cancel

public void cancel()

Description copied from interface: Transaction

Cancels this transaction. If the transaction itself was 'nested' in another transaction, that 'outer' transaction is also canceled. This routine also removes the transaction (and all outer transactions) as an 'active' transaction (it cannot be opened again).

Specified by:

cancel in interface Transaction

finalize

protected void finalize()

If this Transaction is scheduled to be garbage collected, the transaction is canceled and cleaned up. Unless it has already been committed/canceled, ofcourse, and unless the parentcloud of a transaction is a transaction itself. In that case, the parent transaction should cancel! This means that a transaction is always cleared - if it 'times out', or is not properly removed, it will eventually be removed from the MMBase cache.