oracle.ide.runner
Interface DebuggerExtenderCallback

public interface DebuggerExtenderCallback

Interface returned by the debugger when a DebuggerExtender is added. Allows the DebuggerExtender to give commands to the debugger.

Method Summary

DebuggerBreakpoint	addBreakpoint(DebuggerBreakpoint breakpoint) Called by the DebuggerExtender to add a new breakpoint.
boolean	deleteBreakpoint(DebuggerBreakpoint breakpoint) Called by the DebuggerExtender to delete a previously added breakpoint.
javax.swing.Icon	getBreakpointIcon(DebuggerBreakpoint breakpoint) Called by the DebuggerExtender to get the icon that corresponds to the current state of a previously added breakpoint in the context of the current debugging process
java.util.List<? extends DebuggerBreakpoint>	getBreakpoints() Called by the DebuggerExtender to get the list of breakpoints previously added by this DebuggerExtender (and not deleted yet).
DebuggerBreakpoint.BreakpointState	getBreakpointState(DebuggerBreakpoint breakpoint) Called by the DebuggerExtender to get the current state of a previously added breakpoint in the context of the current debugging process
DebuggerBreakpoint.BreakpointScope	getDefaultBreakpointScope() Called by the DebuggerExtender to ask the Debugger what the default breakpoint scope is for new breakpoints.
void	registerCustomBreakpointType(java.lang.String customBreakpointType, DebuggerBreakpoint.BreakpointKind breakpointKind) Called by the DebuggerExtender to register a new custom breakpoint type.
boolean	setEnableBreakpoint(DebuggerBreakpoint breakpoint, boolean enable) Called by the DebuggerExtender to set the preferred state of a previously added breakpoint to enabled or disabled

Method Detail

addBreakpoint

DebuggerBreakpoint addBreakpoint(DebuggerBreakpoint breakpoint)

Called by the DebuggerExtender to add a new breakpoint.

Parameters:

breakpoint - The new breakpoint as defined by the DebuggerExtender

Returns:

The breakpoint as backed by the debugger which will not be the same object as the parameter 'breakpoint' (even though the same interface is used).

deleteBreakpoint

boolean deleteBreakpoint(DebuggerBreakpoint breakpoint)

Called by the DebuggerExtender to delete a previously added breakpoint.

Parameters:

breakpoint - The breakpoint to delete

Returns:

True if the breakpoint was deleted, false otherwise

setEnableBreakpoint

boolean setEnableBreakpoint(DebuggerBreakpoint breakpoint,
                            boolean enable)

Called by the DebuggerExtender to set the preferred state of a previously added breakpoint to enabled or disabled

Parameters:

breakpoint - The breakpoint

enable - True if the preferred state should be set to enabled, false if the preferred state should be set to disabled

Returns:

True if the breakpoint was enabled/disabled, false otherwise

getBreakpoints

java.util.List<? extends DebuggerBreakpoint> getBreakpoints()

Called by the DebuggerExtender to get the list of breakpoints previously added by this DebuggerExtender (and not deleted yet). This method should only be called after the DebuggerExtender method breakpointsLoaded() has been received, and can be called anytime thereafter. A caller can also call this method just once and keep track from then on by monitoring the addBreakpoint and deleteBreakpoint and breakpointDeleted methods.

Returns:

A list of breakpoints which will be null if the debugger has not loaded any breakpoints yet, and empty if there are no breakpoints associated with this DebuggerExtender

getBreakpointState

DebuggerBreakpoint.BreakpointState getBreakpointState(DebuggerBreakpoint breakpoint)

Called by the DebuggerExtender to get the current state of a previously added breakpoint in the context of the current debugging process

Parameters:

breakpoint - The breakpoint

Returns:

One of ENABLED, DISABLED, UNVERIFIED, VERIFIED or null if the breakpoint was not recognized

getBreakpointIcon

javax.swing.Icon getBreakpointIcon(DebuggerBreakpoint breakpoint)

Called by the DebuggerExtender to get the icon that corresponds to the current state of a previously added breakpoint in the context of the current debugging process

Parameters:

breakpoint - The breakpoint

Returns:

An Icon which will be null if the breakpoint was not recognized

registerCustomBreakpointType

void registerCustomBreakpointType(java.lang.String customBreakpointType,
                                  DebuggerBreakpoint.BreakpointKind breakpointKind)

Called by the DebuggerExtender to register a new custom breakpoint type. Breakpoints of this type will return this same type String in their getCustomTypeString() method. The debugger will use this type String to create and edit breakpoints of this type. A good time to call this method is after the breakpointsLoaded call has been received

Parameters:

customBreakpointType - The new custom breakpoint type String. This type is further used by the DebuggerExtender to create and edit breakpoints of this type

breakpointKind - The underlying breakpoint kind of this breakpoint type

getDefaultBreakpointScope

DebuggerBreakpoint.BreakpointScope getDefaultBreakpointScope()

Called by the DebuggerExtender to ask the Debugger what the default breakpoint scope is for new breakpoints. Since the user can change this setting at any time, a good time to call this is when the DebuggerExtender creates a new breakpoint.

Returns:

The default breakpoint scope for new breakpoints.