org.mmbase.bridge
Interface Transaction

All Superinterfaces:

Cloud

public interface Transaction

extends Cloud

A transaction is an environment that allows for the editing of nodes within a 'safe' context. Either all edits in a transaction are comitted, or all fail. A transaction acts as a cloud. All that can be done in a cloud can be done in a transaction. For example a node retrieved using the transaction's getNode method resides in the transaction, if you change or remove the node, you can later roll it back by calling the transaction's cancel method.

Version:

$Id: Transaction.java,v 1.3 2002/01/31 10:05:09 pierre Exp $

Author:

Pierre van Rooden

Method Summary

void	cancel() Cancels this transaction.
boolean	commit() Commits this transaction.

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

Method Detail

commit

public boolean commit()

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).

Returns:

true if the commit succeeded, false otherwise

cancel

public void cancel()

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).