net.ontopia.topicmaps.impl.utils
Interface TopicMapTransactionIF

All Known Implementing Classes:

AbstractTopicMapTransaction, InMemoryTopicMapTransaction, RDBMSTopicMapTransaction, RemoteTopicMapTransaction

Deprecated. All the useful methods have been moved to TopicMapStoreIF and TopicMapIF.

public interface TopicMapTransactionIF

PUBLIC: A topic map transaction is used to represent a transaction in a topic map store. This interface can be used to retrieve a topic map from such a repository and to save changes back to the repository.

To make persistent changes in the topic map, use the commit method. To roll back any changes since the transaction started, call the abort method. (Note that this only works with transactional stores).

The transaction is marked as inactive after a commit or an abort. An inactive transaction can in general not be reactivated.

Method Summary

void	abort() Deprecated. PUBLIC: Aborts the transaction; all changes made inside the transaction are rolled back.
void	commit() Deprecated. PUBLIC: Commits the transaction.
TopicMapBuilderIF	getBuilder() Deprecated. PUBLIC: Gets a topic map builder for use with this transaction.
IndexManagerIF	getIndexManager() Deprecated. PUBLIC: Gets the index manager that manages the topic map indexes in the transaction.
TopicMapStoreIF	getStore() Deprecated. PUBLIC: Gets the store to which the transaction is connected.
TopicMapIF	getTopicMap() Deprecated. PUBLIC: Gets the topic map that is accessible through the transaction.
boolean	isActive() Deprecated. PUBLIC: Returns true if the transaction is active (in process).

Method Detail

getBuilder

TopicMapBuilderIF getBuilder()

Deprecated.

PUBLIC: Gets a topic map builder for use with this transaction.

Returns:

An object implementing TopicMapBuilderIF

Since:

1.2.2

getStore

TopicMapStoreIF getStore()

Deprecated.

PUBLIC: Gets the store to which the transaction is connected.

getTopicMap

TopicMapIF getTopicMap()

Deprecated.

PUBLIC: Gets the topic map that is accessible through the transaction.

Returns:

The topic map in the transaction; an object implementing TopicMapIF.

getIndexManager

IndexManagerIF getIndexManager()

Deprecated.

PUBLIC: Gets the index manager that manages the topic map indexes in the transaction.

Returns:

The index manager used by the transaction: an object implementing IndexManagerIF.

isActive

boolean isActive()

Deprecated.

PUBLIC: Returns true if the transaction is active (in process). A transaction is started immediately after it has been created, so there is no explicit method to call in order to activate a transaction.

Returns:

Boolean: true if active, false if not active (either not yet aborted, or commited).

commit

void commit()

Deprecated.

PUBLIC: Commits the transaction. The changes made are written to the persistent store.

The transaction will resume after the commit meaning that the objects retrieved through is still usable after the commit.

abort

void abort()

Deprecated.

PUBLIC: Aborts the transaction; all changes made inside the transaction are rolled back.

The transaction will resume after the abort meaning that the objects retrieved through is still usable after the abort, but their state has been reverted to the state in the persistent store.