Interface IBmPlatformLocalEditingContext

  • All Superinterfaces:
    IBmPlatformEditingContext

    public interface IBmPlatformLocalEditingContext
    extends IBmPlatformEditingContext
    The local editing context.

    In addition to IBmEditingContext the local editing context allows to navigate through a history of task execution. It can be reached by undo and redo operations. The undo/redo has a coupled canUndo()/canRedo() operation which gives the information about the possibility to perform the undo/redo.

    The editing context can be saved. It means that the modified objects will be written on a disk in resources. The awareness whether editing context has 'unsaved' modifications can be reached by the calling isDirty().

    After all necessary tasks are executed the context should be disposed.

    • Method Detail

      • canUndo

        boolean canUndo()
        Checks if undo operation can be performed.
        Returns:
        true if undo operation can be performed, false otherwise.
      • canRedo

        boolean canRedo()
        Checks if undo operation can be performed.
        Returns:
        true if redo operation can be performed, false otherwise.
      • undo

        void undo()
        Performs the undo operation. Throws an exception if undo operation cannot be performed.
      • redo

        void redo()
        Performs the redo operation. Throws an exception if redo operation cannot be performed.
      • isDirty

        boolean isDirty()
        Checks if the editing context is in the 'unsaved' state.
        Returns:
        true if the editing context is in dirty state, false otherwise.
      • save

        void save()
        Saves the editing context asynchronously. It writes modified in tasks objects into resources.
      • save

        void save​(boolean sync)
        Saves the editing context. It writes modified in tasks objects into resources.
        Parameters:
        sync - The flag indicating whether the editing context will be saved synchronously.
      • dispose

        void dispose()
        Disposes the editing context.
      • addStateListener

        void addStateListener​(IBmEditingContextStateListener listener)
        Adds the given state listener to the editing context.
        Parameters:
        listener - The state listener. May not be null
      • removeStateListener

        void removeStateListener​(IBmEditingContextStateListener listener)
        Removes the given state listener from the editing context.
        Parameters:
        listener - The state listener. May not be null.
      • getUndoContext

        org.eclipse.core.commands.operations.IUndoContext getUndoContext()
        Returns the IUndoContext instance corresponding to the editing context.
        Returns:
        the IUndoContext instance.
      • isDisposed

        boolean isDisposed()
        Checks whether the editing context is disposed.
        Returns:
        true if the editing context is disposed, false otherwise