oracle.ide.debugger.extender

Interface DebuggerExtender

All Superinterfaces:

oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>, oracle.ideimpl.debugger.extender.event.CommonListenerBase<DebuggerExtenderEvent>

public interface DebuggerExtender
extends oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

A DebuggerExtender can modify and enhance certain functionalities of a Debugger. The preferred way to register a DebuggerExtender:
In an extension.xml file, add the registration as follows:
Use a fully qualified class name of an implementation of oracle.ide.runner.DebuggerExtenderDeclarator for the 'class' attribute
Use the ID of the DebuggerExtender for the 'debugger-extender-id' attribute
Add a <trigger-hooks> section or use the existing one
Add a <triggers> section or use the existing one
Add a <jdeveloper-hook> section or use the existing one

<trigger-hooks xmlns="http://xmlns.oracle.com/ide/extension"> <triggers trigger-id="Register My DebuggerExtender"> <jdeveloper-hook xmlns="http://xmlns.oracle.com/jdeveloper/1013/extension">
<debugger-hook>
<debugger-extender class="my.company.DebuggerExtenderDeclarator"
id="MyDebuggerExtenderID" />
</debugger-hook>
</jdeveloper-hook>
</triggers>
</trigger-hooks>

Old, deprecated way of registering a DebuggerExtender Use the Debugger method: DebuggerExtenderCallback addDebuggerExtender( DebuggerExtender extender ); to add a DebuggerExtender to a Debugger.

The existing DebuggerExtenderListener interface, from which DebuggerExtender derives, provides callbacks for some basic Debugger events, such as start, stop, resume, finish

Method Summary

Modifier and Type	Method and Description
void	breakpointAdded(DebuggerExtenderBreakpoint breakpoint) Called by the Debugger when a breakpoint has been added.
void	breakpointChanged(DebuggerExtenderBreakpoint breakpoint, DebuggerExtenderBreakpoint.BreakpointState newState) Called by the Debugger when a previously added breakpoint has changed
void	breakpointDeleted(DebuggerExtenderBreakpoint breakpoint) Called by the Debugger when a previously added breakpoint has been deleted by the user.
void	breakpointInScope(DebuggerExtenderBreakpoint breakpoint) Called by the debugger to tell the DebuggerExtender that a breakpoint has become visible in the scope of the current context, and the Icon of the breakpoint can be shown if appropriate.
void	breakpointOutOfScope(DebuggerExtenderBreakpoint breakpoint) Called by the debugger to tell the DebuggerExtender that a breakpoint has become invisible in the scope of the current context, and the Icon of the breakpoint should be hidden if appropriate.
boolean	breakpointsEqual(DebuggerExtenderBreakpoint debuggerBreakpoint, DebuggerExtenderBreakpoint debuggerExtenderBreakpoint) Called by the debugger to ask the DebuggerExtender if two DebuggerExtenderBreakpoints are equal.
void	breakpointsLoaded() Called by the Debugger to signal that persistent breakpoints have been loaded from storage.
boolean	canCreateCustomBreakpoint(java.lang.String customBreakpointType, Workspace workspace, Project project) Called by the debugger to ask the DebuggerExtender if new breakpoints of a certain type can be created for the incoming workspace and project
boolean	canRunToCursor(Context context, DebuggerExtenderBreakpoint breakpoint) Called when the debugger determines if runToCursor is allowed at a breakpoint.
boolean	canShowBreakpointLocation(Context context, DebuggerExtenderBreakpoint breakpoint) Called by the debugger when actions are enabled/disabled to inquire if the DebuggerExtender wants to disable the action that shows the location corresponding to the breakpoint.
boolean	canShowIPLocation(Context context, DebuggerExtenderBreakpoint breakpoint) Called by the debugger when the debuggee is stopped at a previously added breakpoint.
default boolean	canShowIPLocation(Context context, DebuggerExtenderSourceLocation location) Called by the debugger when the debuggee is stopped at a non-breakpoint location.
boolean	canStepInto(Context context, DebuggerExtenderBreakpoint breakpoint) Called when the debugger determines if stepInto is allowed at a breakpoint.
boolean	canStepOut(Context context, DebuggerExtenderBreakpoint breakpoint) Called when the debugger determines if stepOut is allowed at a breakpoint.
boolean	canStepOver(Context context, DebuggerExtenderBreakpoint breakpoint) Called by the debugger to determine if the DebuggerExtender wants to override the StepOver behavior.
boolean	canStepToEndOfMethod(Context context, DebuggerExtenderBreakpoint breakpoint) Called when the debugger determines if stepToEndOfMethod is allowed at a breakpoint.
void	debuggeeStoppedAtBreakpoint(Context context, DebuggerExtenderBreakpoint breakpoint) Called by the Debugger when the debuggee has stopped at a previously added breakpoint.
DebuggerExtenderBreakpointPanel	getCustomBreakpointPanel(java.lang.String customBreakpointType, DebuggerExtenderBreakpoint breakpoint, javax.swing.event.ChangeListener changeListener) Called by the debugger to ask the DebuggerExtender for the panel to create or edit a custom breakpoint.
default DebuggerExtenderAPIVersion	getDebuggerExtenderAPIVersion() Called by the Debugger to get the API version implemented by this DebuggerExtender.
java.lang.String	getID() Called by the Debugger to get the unique ID that identifies this DebuggerExtender Warning: This method will be called during the call to method: DebuggerExtenderCallback addDebuggerExtender( DebuggerExtender extender );
void	newDebugSession(Context context) Called by the debugger before a new debug session is started on the incoming context.
DebuggerExtenderBreakpoint	runToCursor(Context context, DebuggerExtenderBreakpoint breakpoint) Called when the debugger will execute a RunToCursor command.
void	setEvaluator(Context context, DebuggerExtenderEvaluator evaluator) Called after the debuggee has stopped and the stack window is refreshed.
boolean	showBreakpointLocation(Context context, DebuggerExtenderBreakpoint breakpoint) Called by the debugger when the user double-clicks on a previously added breakpoint.
boolean	showIPLocation(Context context, DebuggerExtenderBreakpoint breakpoint) Called by the debugger when the debuggee is stopped at a previously added breakpoint.
default boolean	showIPLocation(Context context, DebuggerExtenderSourceLocation location) Called by the debugger when the debuggee is stopped at a non-breakpoint location owned by the extender.
DebuggerExtenderBreakpoint	stepInto(Context context, DebuggerExtenderBreakpoint breakpoint) Called when the debugger will execute a StepInto command.
DebuggerExtenderBreakpoint	stepOut(Context context, DebuggerExtenderBreakpoint breakpoint) Called when the debugger will execute a StepOut command.
DebuggerExtenderBreakpoint	stepOver(Context context, DebuggerExtenderBreakpoint breakpoint) Called when the debugger will execute a StepOver command.
DebuggerExtenderBreakpoint	stepToEndOfMethod(Context context, DebuggerExtenderBreakpoint breakpoint) Called when the debugger will execute a StepToEndOfMethod command.
void	temporaryBreakpointSet(Context context, DebuggerExtenderBreakpoint breakpoint) Called by the debugger to tell the DebuggerExtender that the temporary breakpoint, requested by the DebuggerExtender for the overriding stepping behavior, has been set
void	updateBreakpointIcon(DebuggerExtenderBreakpoint breakpoint) Called by the debugger to tell the DebuggerExtender that the Icon of a breakpoint should be updated, which only makes sense if the breakpoint is currently visible in the IDE.

Methods inherited from interface oracle.ideimpl.debugger.extender.event.CommonListenerBase

debuggerFinished, debuggerResuming, debuggerStarted, debuggerStopping

Method Detail

getDebuggerExtenderAPIVersion

default DebuggerExtenderAPIVersion getDebuggerExtenderAPIVersion()

Called by the Debugger to get the API version implemented by this DebuggerExtender. Implementors should not override this.

Specified by:

getDebuggerExtenderAPIVersion in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

getID

java.lang.String getID()

Called by the Debugger to get the unique ID that identifies this DebuggerExtender Warning: This method will be called during the call to method: DebuggerExtenderCallback addDebuggerExtender( DebuggerExtender extender );

Specified by:

getID in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Returns:

The unique ID of this DebuggerExtender which should not be null

breakpointsLoaded

void breakpointsLoaded()

Called by the Debugger to signal that persistent breakpoints have been loaded from storage. Warning: This method might be called during the call to method: DebuggerExtenderCallback addDebuggerExtender( DebuggerExtender extender );

Specified by:

breakpointsLoaded in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

newDebugSession

void newDebugSession(Context context)

Called by the debugger before a new debug session is started on the incoming context. This is an excellent time to add breakpoints relevant to the new debug sessions or delete non-relevant breakpoints

Specified by:

newDebugSession in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context for the new debug session, which might be null

debuggeeStoppedAtBreakpoint

void debuggeeStoppedAtBreakpoint(Context context,
                                 DebuggerExtenderBreakpoint breakpoint)

Called by the Debugger when the debuggee has stopped at a previously added breakpoint. This is not the call that asks the DebuggerExtender to render the stopped debuggee location, that will arrive later

Specified by:

debuggeeStoppedAtBreakpoint in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender.

breakpointAdded

void breakpointAdded(DebuggerExtenderBreakpoint breakpoint)

Called by the Debugger when a breakpoint has been added. This can be a breakpoint previously added by the DebuggerExtenderCallback, or a breakpoint loaded from disk, or a breakpoint created by the user.

Specified by:

breakpointAdded in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

breakpoint - A breakpoint which is guaranteed to be a breakpoint belonging to this DebuggerExtender

breakpointChanged

void breakpointChanged(DebuggerExtenderBreakpoint breakpoint,
                       DebuggerExtenderBreakpoint.BreakpointState newState)

Called by the Debugger when a previously added breakpoint has changed

Specified by:

breakpointChanged in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

breakpoint - The breakpoint that has changed, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

newState - The new state of the breakpoint

breakpointDeleted

void breakpointDeleted(DebuggerExtenderBreakpoint breakpoint)

Called by the Debugger when a previously added breakpoint has been deleted by the user. This method will not be called when the DebuggerExtenderCallback initiated the breakpoint deletion

Specified by:

breakpointDeleted in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

breakpoint - The breakpoint that has been deleted, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

canShowBreakpointLocation

boolean canShowBreakpointLocation(Context context,
                                  DebuggerExtenderBreakpoint breakpoint)

Called by the debugger when actions are enabled/disabled to inquire if the DebuggerExtender wants to disable the action that shows the location corresponding to the breakpoint.

Specified by:

canShowBreakpointLocation in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session if there is an active debug session, otherwise null

breakpoint - The breakpoint, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

False if the action to show the location of this breakpoint should be disabled, true otherwise

showBreakpointLocation

boolean showBreakpointLocation(Context context,
                               DebuggerExtenderBreakpoint breakpoint)

Called by the debugger when the user double-clicks on a previously added breakpoint. This gives the DebuggerExtender the chance to display the visuals that represent the place where the debuggee would stop. This is not the time to display any execution point, but instead any relevant breakpoints should be displayed with their state

Specified by:

showBreakpointLocation in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session if there is an active debug session, otherwise null

breakpoint - The breakpoint, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

True if the DebuggerExtender successfully showed the location of the breakpoint, false if the DebuggerExtender wants the Debugger to show the location instead

canShowIPLocation

boolean canShowIPLocation(Context context,
                          DebuggerExtenderBreakpoint breakpoint)

Called by the debugger when the debuggee is stopped at a previously added breakpoint. 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: - the first time the debuggee stops at a previously added breakpoint - any time the user executes the 'show IP' action when the debuggee is stopped at a previously added breakpoint - any time the user clicks on the top frame of the current stack when the debuggee is stopped at a previously added breakpoint

Specified by:

canShowIPLocation in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint 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,
                       DebuggerExtenderBreakpoint breakpoint)

Called by the debugger when the debuggee is stopped at a previously added breakpoint. 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: - the first time the debuggee stops at a previously added breakpoint - any time the user executes the 'show IP' action when the debuggee is stopped at a previously added breakpoint - any time the user clicks on the top frame of the current stack when the debuggee is stopped at a previously added breakpoint

Specified by:

showIPLocation in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint 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.

setEvaluator

void setEvaluator(Context context,
                  DebuggerExtenderEvaluator evaluator)

Called after the debuggee has stopped and the stack window is refreshed. Will be called after the 'showIPLocation' call. If the DebuggerExtender needs access to an evaluator during the rendering, it should delay that rendering till after setEvaluator is called. The first time this is called (after the debuggee has stopped), the stackFrameIndex will always be 0 (zero), and the thread will be the 'stopped' thread. Each time the user changes stackframe or thread, this method will be called again with a new Evaluator, valid for that thread and stackframe. Evaluators are keyed to a particular stop, thread and stackframe and will be expired in any other situation. Don't hold on to expired evaluators. Let them be garbage collected after each 'resume' and 'finish'.

Specified by:

setEvaluator in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

evaluator - An evaluator that can be used during this debuggee stop.

stepOver

DebuggerExtenderBreakpoint stepOver(Context context,
                                    DebuggerExtenderBreakpoint breakpoint)

Called when the debugger will execute a StepOver command. Allows the DebuggerExtender to modify the semantics of 'StepOver' issued at a certain breakpoint. StepOver cannot be disabled by DebuggerExtenders since it is part of standard stepping functionality. The DebuggerExtender can either change a StepOver command into a run to a temporary breakpoint or into a resume.

Specified by:

stepOver in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

A DebuggerBreakpoint (implemented by the DebuggerExtender) if the DebuggerExtender wants the debugger to attempt to run to this breakpoint. Return null if the DebuggerExtender wants the debugger to just resume. There is no guarantee that the debuggee will indeed make its next stop at the returned breakpoint, since any other breakpoint can be hit first instead. The returned breakpoint is a temporary, invisible breakpoint which is automatically deleted at the end of this command

canStepOver

boolean canStepOver(Context context,
                    DebuggerExtenderBreakpoint breakpoint)

Called by the debugger to determine if the DebuggerExtender wants to override the StepOver behavior. StepOver cannot be disabled, since it is part of standard stepping functionality. However, the DebuggerExtender can choose to override StepOver OR let the debugger do a default StepOver action. Overriding StepOver can be done by requesting the debugger to run to a temporary breakpoint, or by requesting the debugger to resume. This method can be called several times after the debuggee stops at a breakpoint. The debugger guarantees to call this method after the setEvaluator call, so if this DebuggerExtender needs evaluator services for this method, it should ignore this method till after the setEvaluator call.

Specified by:

canStepOver in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

True if the DebuggerExtender wants to override the StepOver action, false if the DebuggerExtender wants the debugger to execute a default StepOver action.

stepInto

DebuggerExtenderBreakpoint stepInto(Context context,
                                    DebuggerExtenderBreakpoint breakpoint)

Called when the debugger will execute a StepInto command. Allows the DebuggerExtender to modify the semantics of 'StepInto' issued at a certain breakpoint. StepInto can be disabled by the DebuggerExtender through the canStepInto call

Specified by:

stepInto in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

A DebuggerExtenderBreakpoint (implemented by the DebuggerExtender) if the DebuggerExtender wants the debugger to attempt to run to this breakpoint instead of doing a normal StepInto which is step into the current statement. Return null if the DebuggerExtender wants the debugger to perform the normal StepInto command. There is no guarantee that the debuggee will indeed make its next stop at the returned breakpoint, since any other breakpoint can be hit first instead. The returned breakpoint is a temporary, invisible breakpoint which is automatically deleted at the end of this command

canStepInto

boolean canStepInto(Context context,
                    DebuggerExtenderBreakpoint breakpoint)

Called when the debugger determines if stepInto is allowed at a breakpoint. Allows the DebuggerExtender to disable stepInto at a breakpoint This method can be called several times after the debuggee stops at a breakpoint. The debugger guarantees to call this method after the setEvaluator call, so if this DebugExtender needs evaluator services for this method, it should ignore this method till after the setEvaluator call.

Specified by:

canStepInto in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

False if stepInto should be disabled at this breakpoint, true otherwise.

stepOut

DebuggerExtenderBreakpoint stepOut(Context context,
                                   DebuggerExtenderBreakpoint breakpoint)

Called when the debugger will execute a StepOut command. Allows the DebuggerExtender to modify the semantics of 'StepOut' issued at a certain breakpoint. StepOut can be disabled by the DebuggerExtender through the canStepOut call

Specified by:

stepOut in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

A DebuggerExtenderBreakpoint (implemented by the DebuggerExtender) if the DebuggerExtender wants the debugger to attempt to run to this breakpoint instead of doing a normal StepOut which is step out of the current function. Return null if the DebuggerExtender wants the debugger to perform the normal StepOut command. There is no guarantee that the debuggee will indeed make its next stop at the returned breakpoint, since any other breakpoint can be hit first instead. The returned breakpoint is a temporary, invisible breakpoint which is automatically deleted at the end of this command

canStepToEndOfMethod

boolean canStepToEndOfMethod(Context context,
                             DebuggerExtenderBreakpoint breakpoint)

Called when the debugger determines if stepToEndOfMethod is allowed at a breakpoint. Allows the DebuggerExtender to disable stepToEndOfMethod. This method can be called several times after the debuggee stops at a breakpoint. The debugger guarantees to call this method after the setEvaluator call, so if this DebuggerExtender needs evaluator services for this method, it should ignore this method till after the setEvaluator call.

Specified by:

canStepToEndOfMethod in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

False if the stepToEndOfMethod functionality should be disabled, true otherwise.

stepToEndOfMethod

DebuggerExtenderBreakpoint stepToEndOfMethod(Context context,
                                             DebuggerExtenderBreakpoint breakpoint)

Called when the debugger will execute a StepToEndOfMethod command. Allows the DebuggerExtender to modify the semantics of 'StepToEndOfMethod' issued at a certain breakpoint. StepToEndOfMethod can be disabled by the DebuggerExtender through the canStepToEndOfMethod call

Specified by:

stepToEndOfMethod in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

A DebuggerExtenderBreakpoint (implemented by the DebuggerExtender) if the DebuggerExtender wants the debugger to attempt to run to this breakpoint instead of doing a normal StepToEndOfMethod which is step to the end of the current function. Return null if the DebuggerExtender wants the debugger to perform the normal StepToEndOfMethod command. There is no guarantee that the debuggee will indeed make its next stop at the returned breakpoint, since any other breakpoint can be hit first instead. The returned breakpoint is a temporary, invisible breakpoint which is automatically deleted at the end of this command

canStepOut

boolean canStepOut(Context context,
                   DebuggerExtenderBreakpoint breakpoint)

Called when the debugger determines if stepOut is allowed at a breakpoint. Allows the DebuggerExtender to disable stepOut at a breakpoint This method can be called several times after the debuggee stops at a breakpoint. The debugger guarantees to call this method after the setEvaluator call, so if this DebugExtender needs evaluator services for this method, it should ignore this method till after the setEvaluator call.

Specified by:

canStepOut in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

False if the stepOut functionality should be disabled, true otherwise.

runToCursor

DebuggerExtenderBreakpoint runToCursor(Context context,
                                       DebuggerExtenderBreakpoint breakpoint)

Called when the debugger will execute a RunToCursor command. Allows the DebuggerExtender to modify the semantics of 'RunToCursor' issued at a certain breakpoint. RunToCursor can be disabled by the DebuggerExtender through the canRunToCursor call

Specified by:

runToCursor in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

A DebuggerExtenderBreakpoint (implemented by the DebuggerExtender) if the DebuggerExtender wants the debugger to attempt to run to this breakpoint instead of doing a normal RunToCursor which is run to the location where the cursor is. Return null if the DebuggerExtender wants the debugger to perform the normal RunToCursor command. There is no guarantee that the debuggee will indeed make its next stop at the returned breakpoint, since any other breakpoint can be hit first instead. The returned breakpoint is a temporary, invisible breakpoint which is automatically deleted at the end of this command

canRunToCursor

boolean canRunToCursor(Context context,
                       DebuggerExtenderBreakpoint breakpoint)

Called when the debugger determines if runToCursor is allowed at a breakpoint. Allows the DebuggerExtender to disable runToCursor This method can be called several times after the debuggee stops at a breakpoint. The debugger guarantees to call this method after the setEvaluator call, so if this DebuggerExtender needs evaluator services for this method, it should ignore this method till after the setEvaluator call.

Specified by:

canRunToCursor in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The breakpoint where the debuggee is stopped, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

Returns:

False if the runToCursor functionality should be disabled, true otherwise.

breakpointInScope

void breakpointInScope(DebuggerExtenderBreakpoint breakpoint)

Called by the debugger to tell the DebuggerExtender that a breakpoint has become visible in the scope of the current context, and the Icon of the breakpoint can be shown if appropriate. It is up to the DebuggerExtender to keep an internal state of the visiblity of the breakpoint. The DebuggerExtender can call getBreakpointState and getBreakpointIcon to determine what to show

Specified by:

breakpointInScope in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

breakpoint - The breakpoint, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

breakpointOutOfScope

void breakpointOutOfScope(DebuggerExtenderBreakpoint breakpoint)

Called by the debugger to tell the DebuggerExtender that a breakpoint has become invisible in the scope of the current context, and the Icon of the breakpoint should be hidden if appropriate. It is up to the DebuggerExtender to keep an internal state of the visiblity of the breakpoint.

Specified by:

breakpointOutOfScope in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

breakpoint - The breakpoint, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

updateBreakpointIcon

void updateBreakpointIcon(DebuggerExtenderBreakpoint breakpoint)

Called by the debugger to tell the DebuggerExtender that the Icon of a breakpoint should be updated, which only makes sense if the breakpoint is currently visible in the IDE. The DebuggerExtender can call back with getBreakpointState and getBreakpointIcon to determine what to show

Specified by:

updateBreakpointIcon in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

breakpoint - The breakpoint, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

temporaryBreakpointSet

void temporaryBreakpointSet(Context context,
                            DebuggerExtenderBreakpoint breakpoint)

Called by the debugger to tell the DebuggerExtender that the temporary breakpoint, requested by the DebuggerExtender for the overriding stepping behavior, has been set

Specified by:

temporaryBreakpointSet in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

breakpoint - The temporary breakpoint set by the debugger, which is guaranteed to be a breakpoint belonging to this DebuggerExtender

breakpointsEqual

boolean breakpointsEqual(DebuggerExtenderBreakpoint debuggerBreakpoint,
                         DebuggerExtenderBreakpoint debuggerExtenderBreakpoint)

Called by the debugger to ask the DebuggerExtender if two DebuggerExtenderBreakpoints are equal. This method will be used to resolve DebuggerBreakpoints that the debugger does not recognize as its own.

Specified by:

breakpointsEqual in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

debuggerBreakpoint - A DebuggerExtenderBreakpoint as backed by the debugger

debuggerExtenderBreakpoint - A DebuggerExtenderBreakpoint as backed by the DebuggerExtender

Returns:

true if the DebuggerExtender thinks the two breakpoints are equal

canCreateCustomBreakpoint

boolean canCreateCustomBreakpoint(java.lang.String customBreakpointType,
                                  Workspace workspace,
                                  Project project)

Called by the debugger to ask the DebuggerExtender if new breakpoints of a certain type can be created for the incoming workspace and project

Specified by:

canCreateCustomBreakpoint in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

customBreakpointType - The type of the new breakpoint, which is one of the types registered by the DebuggerExtenderCallback in the registerCustomBreakpointType call

workspace - The workspace which might be null but is usually not null

project - The project which might be null but is usually not null

Returns:

True if this DebuggerExtender can create the specific breakpoint in the context of the workspace and project

getCustomBreakpointPanel

DebuggerExtenderBreakpointPanel getCustomBreakpointPanel(java.lang.String customBreakpointType,
                                                         DebuggerExtenderBreakpoint breakpoint,
                                                         javax.swing.event.ChangeListener changeListener)

Called by the debugger to ask the DebuggerExtender for the panel to create or edit a custom breakpoint.

Specified by:

getCustomBreakpointPanel in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

customBreakpointType - The type of the new breakpoint, which is one of the types registered by the DebuggerExtenderCallback in the registerCustomBreakpointType call

breakpoint - The breakpoint which will be null when the user will create a new breakpoint, and not null when the user will edit an existing breakpoint

changeListener - The DebuggerExtender can notify the debugger through this listener when anything has changed on the DebuggerExtenderBreakpointPanel; this will cause the debugger to check if the OK button can be enabled or not.

Returns:

A panel; if null is returned the debugger will create a panel based on the kind of the breakpoint

canShowIPLocation

default boolean canShowIPLocation(Context context,
                                  DebuggerExtenderSourceLocation 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

Specified by:

canShowIPLocation in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

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

default boolean showIPLocation(Context context,
                               DebuggerExtenderSourceLocation 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

Specified by:

showIPLocation in interface oracle.ideimpl.debugger.extender.CommonExtenderBase<DebuggerExtenderBreakpoint,DebuggerExtenderEvaluator,DebuggerExtenderSourceLocation,DebuggerExtenderBreakpointPanel,DebuggerExtenderEvent,DebuggerExtenderBreakpoint.BreakpointState>

Parameters:

context - The context of the debug session

location - The location where the debuggee is stopped, which is in a source 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.