javax.ide.model
Interface Transaction

All Known Subinterfaces:

TextModel, XMLModel

public interface Transaction

Method Summary

void	beginEdit() Used to instruct a model to start a compound edit such that all the changes made between this point and when the endEdit() is called should be combined into a single UndoableEdit record.
javax.swing.undo.UndoableEdit	commitEdit() Used to indicate to the text buffer to end an in progress compound edit.
void	rollbackEdit() Used to indicate to the text buffer to end an in progress compound edit without commiting the changes.
void	write(java.lang.Runnable runnable) This allows the model to be safely updated.

Method Detail

beginEdit

void beginEdit()
               throws java.io.IOException

Used to instruct a model to start a compound edit such that all the changes made between this point and when the endEdit() is called should be combined into a single UndoableEdit record. This guarantees to the client that the buffer will be locked for the duration between beginEdit() and endEdit() for data consistency. This also takes care of locking the buffer, and collecting the individual UndoableEdit objects into a larger compound one.

Note that compound edits may not be nested - it is illegal to call beginEdit() twice in a row without calling endEdit() in between.

Throws:

ReadOnlyException - if the buffer is in read only mode

java.io.IOException

commitEdit

javax.swing.undo.UndoableEdit commitEdit()

Used to indicate to the text buffer to end an in progress compound edit. This will end the compound edit and returned the single combined UndoableEdit representing all of the changes made between the calls to beginEdit() and endEdit(). If no modifications were made to the buffer since beginEdit() was called, null will be returned.

Returns:

the UndoableEdit representing all the changes made

rollbackEdit

void rollbackEdit()

Used to indicate to the text buffer to end an in progress compound edit without commiting the changes. The text buffer will be left in the same state it was found when the call to beginEdit was made.

write

void write(java.lang.Runnable runnable)

This allows the model to be safely updated. The given runnable will be executed in a way that allows it to safely write to the model (with no changes from other threads) while the runnable is being executed. Multiple write calls from the same thread are allowed.

Parameters:

runnable - a Runnable used to write to the model.