Package org.eclipse.debug.ui.actions

Class RunToLineHandler

java.lang.Object

org.eclipse.debug.ui.actions.RunToLineHandler

All Implemented Interfaces:

IWorkspaceRunnable, ICoreRunnable, IBreakpointManagerListener, IDebugEventSetListener

public class RunToLineHandler
extends java.lang.Object
implements IDebugEventSetListener, IBreakpointManagerListener, IWorkspaceRunnable

Handles a run to line operation. Clients implementing a run to line action can use this handler to carry out a run to line operation implemented with a breakpoint. Handles the user preference to skip breakpoints while performing a run to line operation, and cancelling the run to line operation if another breakpoint is encountered before the operation is completed.

Clients may instantiate this class.

Since:

3.1

Restriction:

This class is not intended to be subclassed by clients.

Constructor Summary

Constructors

Constructor	Description
RunToLineHandler(IDebugTarget target, ISuspendResume suspendResume, IBreakpoint breakpoint)	Constructs a handler to perform a run to line operation.

Method Summary

Modifier and Type	Method	Description
void	breakpointManagerEnablementChanged(boolean enabled)	Notifies the listener that the breakpoint manager's enablement has changed.
void	cancel()	Cancels the run to line operation.
void	handleDebugEvents(DebugEvent[] events)	Notifies this listener of the given debug events.
void	run(IProgressMonitor monitor)	Executes this runnable.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.eclipse.debug.core.IBreakpointManagerListener

breakpointManagerTriggerPointChanged

Constructor Detail

RunToLineHandler

public RunToLineHandler(IDebugTarget target,
                        ISuspendResume suspendResume,
                        IBreakpoint breakpoint)

Constructs a handler to perform a run to line operation.

Parameters:

target - the debug target in which the operation is to be performed

suspendResume - the element to be resumed to begin the operation

breakpoint - the run to line breakpoint

Method Detail

handleDebugEvents

public void handleDebugEvents(DebugEvent[] events)

Description copied from interface: IDebugEventSetListener

Notifies this listener of the given debug events. All of the events in the given event collection occurred at the same location the program be run or debugged.

Specified by:

handleDebugEvents in interface IDebugEventSetListener

Parameters:

events - the debug events

breakpointManagerEnablementChanged

public void breakpointManagerEnablementChanged(boolean enabled)

Description copied from interface: IBreakpointManagerListener

Notifies the listener that the breakpoint manager's enablement has changed.

Specified by:

breakpointManagerEnablementChanged in interface IBreakpointManagerListener

Parameters:

enabled - whether or not the breakpoint manager is enabled

cancel

public void cancel()

Cancels the run to line operation.

run

public void run(IProgressMonitor monitor)
         throws CoreException

Description copied from interface: ICoreRunnable

Executes this runnable.

The provided monitor can be used to report progress and respond to cancellation. If the progress monitor has been canceled, the runnable should finish its execution at the earliest convenience and throw an OperationCanceledException. A CoreException with a status of severity IStatus.CANCEL has the same effect as an OperationCanceledException.

Specified by:

run in interface ICoreRunnable

Specified by:

run in interface IWorkspaceRunnable

Parameters:

monitor - a progress monitor, or null if progress reporting and cancellation are not desired. The monitor is only valid for the duration of the invocation of this method. Callers may call IProgressMonitor.done() after this method returns or throws an exception, but this is not strictly required.

Throws:

CoreException - if this operation fails