oracle.javatools.parser.java.v2.write
Interface SourceTransaction

public interface SourceTransaction

A logical grouping of write operations on a SourceFile.

Method Summary

void	abort() Rolls back changes to the beginning of the transaction and releases all locked resources.
void	addListener(SourceTransactionListener listener) Registers the given observer to begin receiving notifications when changes are made on this SourceFile or when this SourceFile is invalidated.
javax.swing.undo.UndoableEdit	commit() Logically ends this transaction.
java.util.Collection	getChanges() Deprecated. Not supported in this production release.
SourceFile	getOwningSourceFile()
void	removeListener(SourceTransactionListener listener) Unregisters the given observer.
void	rollback() Rolls back all changes made in this transaction, but keeps the transaction open.
void	rollback(SourceSavepoint savepoint) Rolls back changes up to the given savepoint.
SourceSavepoint	savepoint()

Method Detail

getOwningSourceFile

SourceFile getOwningSourceFile()

Returns:

The SourceFile this transaction is attached to.

savepoint

SourceSavepoint savepoint()

Returns:

A savepoint that can be used with rollback.

rollback

void rollback(SourceSavepoint savepoint)

Rolls back changes up to the given savepoint.

rollback

void rollback()

Rolls back all changes made in this transaction, but keeps the transaction open. Compare with abort() which closes the transaction.

commit

javax.swing.undo.UndoableEdit commit()

Logically ends this transaction. Commits the transaction's changes and releases all locked resources.

Returns:

Null if this transaction involved no changes.

abort

void abort()

Rolls back changes to the beginning of the transaction and releases all locked resources.

addListener

void addListener(SourceTransactionListener listener)

Registers the given observer to begin receiving notifications when changes are made on this SourceFile or when this SourceFile is invalidated. If the input listener is already registered with this SourceFile, no action is taken.

Parameters:

listener - The listener to be added.

removeListener

void removeListener(SourceTransactionListener listener)

Unregisters the given observer. Equality is determined by ==. If the input listener is not registered with this SourceFile, no action is taken.

Parameters:

listener - The listener to be removed.

getChanges

@Deprecated
java.util.Collection getChanges()

Deprecated. Not supported in this production release.

Causes an implicit savepoint().

Returns:

The net array of changes that are a result of this transaction.