oracle.ide.runner

Interface DebuggerExtender2

All Superinterfaces:

DebuggerExtender, DebuggerListener, java.util.EventListener

public interface DebuggerExtender2
extends DebuggerExtender

This interface extends DebuggerExtender by adding methods that are used to control showing the Instruction Pointer (IP) at non-breakpoint locations, as may result from a step operation, pop back to here, or run to cursor.

Method Summary

Modifier and Type	Method and Description
boolean	canShowIPLocation(Context context, DebuggerLocation location) Called by the debugger when the debuggee is stopped at a non-breakpoint location.
boolean	showIPLocation(Context context, DebuggerLocation location) Called by the debugger when the debuggee is stopped at a non-breakpoint location owned by the extender.

Methods inherited from interface oracle.ide.runner.DebuggerExtender

breakpointAdded, breakpointChanged, breakpointDeleted, breakpointInScope, breakpointOutOfScope, breakpointsEqual, breakpointsLoaded, canCreateCustomBreakpoint, canRunToCursor, canShowBreakpointLocation, canShowIPLocation, canStepInto, canStepOut, canStepOver, canStepToEndOfMethod, debuggeeStoppedAtBreakpoint, getCustomBreakpointPanel, getID, newDebugSession, runToCursor, setEvaluator, showBreakpointLocation, showIPLocation, stepInto, stepOut, stepOver, stepToEndOfMethod, temporaryBreakpointSet, updateBreakpointIcon

Methods inherited from interface oracle.ide.runner.DebuggerListener

debuggerFinished, debuggerResuming, debuggerStarted, debuggerStopping

Method Detail

canShowIPLocation

boolean canShowIPLocation(Context context,
                          DebuggerLocation location)

Called by the debugger when the debuggee is stopped at a non-breakpoint location. The debugger is asking if the DebuggerExtender will display all visuals to represent the stopped debuggee (IP) location, including the execution point. There are several situations where this method can be called: - following a step operation - following a pop back to here operation - following a run to cursor operation In any of the above cases, if the ExtenderManager determines that the source location where we are stopped is owned by the extender, then the extender will be asked if it wants to handle showing the IP

Parameters:

context - The context of the debug session

location - The location where the debuggee is stopped, which is a source location belonging to this DebuggerExtender

Returns:

True if the DebuggerExtender will display the IP location. False if the debugger should display the IP location

showIPLocation

boolean showIPLocation(Context context,
                       DebuggerLocation location)

Called by the debugger when the debuggee is stopped at a non-breakpoint location owned by the extender. The debugger is giving the DebuggerExtender the chance to display all visuals to represent the stopped debuggee (IP) location, including the execution point. There are several situations where this method can be called: - following a step operation - following a pop back to here operation - following a run to cursor operation In any of the above cases, if the ExtenderManager determines that the source location where we are stopped is owned by the extender, then the extender will be asked if it wants to handle showing the IP

Parameters:

context - The context of the debug session

location - The location where the debuggee is stopped, which is in a souce file belonging to this DebuggerExtender

Returns:

True if the DebuggerExtender successfully rendered the IP location, false if for some reason the DebuggerExtender failed to render the IP location (e.g. an Exception), and the debugger will attempt to render the IP location instead.