com.metamatrix.common.transaction
Interface UserTransactionFactory

All Known Subinterfaces:

DirectoryEntryEditor, DirectoryEntryView, PropertiedObjectEditor, PropertiedObjectsEditor, PropertiedObjectView, TreeNodeEditor, TreeView

All Known Implementing Classes:

AbstractTreeView, BasicTreeNodeEditor, BasicTreeView, ConfigurationPropertiedObjectEditor, ConsolePropertiedEditor, DefaultTreeNodeEditor, DefaultTreeView, FileSystemEntryEditor, FileSystemView, PropertiedObjectEditorImpl, PropertiedObjectsEditorImpl, ResourcePropertiedObjectEditor, RuledDirectoryEntryViewImpl, RuledTreeViewImpl, SimpleUserTransactionFactory

public interface UserTransactionFactory

Method Summary

UserTransaction	createReadTransaction() Create a new instance of a UserTransaction that may be used to read information.
UserTransaction	createWriteTransaction() Create a new instance of a UserTransaction that may be used to write and/or update information.
UserTransaction	createWriteTransaction(java.lang.Object source) Create a new instance of a UserTransaction that may be used to write and/or update information.

Method Detail

createReadTransaction

UserTransaction createReadTransaction()

Create a new instance of a UserTransaction that may be used to read information. Read transactions do not have a source object associated with them (since they never directly modify data).

The returned transaction object will not be bound to an underlying system transaction until begin() is called on the returned object.

Returns:

the new transaction object

createWriteTransaction

UserTransaction createWriteTransaction()

Create a new instance of a UserTransaction that may be used to write and/or update information. The transaction will not have a source object associated with it.

The returned transaction object will not be bound to an underlying system transaction until begin() is called on the returned object.

Returns:

the new transaction object

createWriteTransaction

UserTransaction createWriteTransaction(java.lang.Object source)

Create a new instance of a UserTransaction that may be used to write and/or update information. The source object will be used for all events that are fired as a result of or as a product of this transaction.

The returned transaction object will not be bound to an underlying system transaction until begin() is called on the returned object.

Parameters:

source - the object that is considered to be the source of the transaction; may be null

Returns:

the new transaction object