Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK
11g Release 2 (11.1.2.2.0)

E17493-03


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.
 boolean editBreakpoint(DebuggerBreakpoint breakpoint)
          Called by the DebuggerExtender to ask the Debugger to show the dialog where the user can edit the incoming 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.
 DebuggerBreakpoint getDefaultBreakpointSettings()
          Called by the DebuggerExtender to ask the Debugger for the settings of a 'default' breakpoint.
 void registerCustomBreakpointType(java.lang.String customBreakpointType, DebuggerBreakpoint.BreakpointKind breakpointKind)
          Deprecated. Use registerCustomBreakpointType(String, BreakpointKind, DebuggerBreakpoint) instead.
 void registerCustomBreakpointType(java.lang.String customBreakpointType, DebuggerBreakpoint.BreakpointKind breakpointKind, DebuggerBreakpoint breakpointTemplate)
          Deprecated. The programmatic way of registering breakpoint types is discouraged. Instead register in a declarative way in extension.xml, as follows: Use a fully qualified class name of an implementation of oracle.ide.runner.DebuggerBreakpointDeclarator for the 'class' attribute
Use the unique type string of the breakpoint type for the 'type-string' attribute, such as 'ADF Breakpoint'
Add a <hooks> section or use the existing one
Add a <jdeveloper-hook> section or use the existing one

<hooks>
<jdeveloper-hook xmlns="http://xmlns.oracle.com/jdeveloper/1013/extension">
<debugger-hook>
<debugger-extender-custom-breakpoint-type
class="mycompany.MyDebuggerBreakpointDeclarator" type-string="My Breakpoint" />
</debugger-hook>
</jdeveloper-hook>
</hooks>

 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

@Deprecated
void registerCustomBreakpointType(java.lang.String customBreakpointType,
                                             DebuggerBreakpoint.BreakpointKind breakpointKind)
Deprecated. Use registerCustomBreakpointType(String, BreakpointKind, DebuggerBreakpoint) instead.
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

registerCustomBreakpointType

@Deprecated
void registerCustomBreakpointType(java.lang.String customBreakpointType,
                                             DebuggerBreakpoint.BreakpointKind breakpointKind,
                                             DebuggerBreakpoint breakpointTemplate)
Deprecated. The programmatic way of registering breakpoint types is discouraged. Instead register in a declarative way in extension.xml, as follows: Use a fully qualified class name of an implementation of oracle.ide.runner.DebuggerBreakpointDeclarator for the 'class' attribute
Use the unique type string of the breakpoint type for the 'type-string' attribute, such as 'ADF Breakpoint'
Add a <hooks> section or use the existing one
Add a <jdeveloper-hook> section or use the existing one

<hooks>
<jdeveloper-hook xmlns="http://xmlns.oracle.com/jdeveloper/1013/extension">
<debugger-hook>
<debugger-extender-custom-breakpoint-type
class="mycompany.MyDebuggerBreakpointDeclarator" type-string="My Breakpoint" />
</debugger-hook>
</jdeveloper-hook>
</hooks>

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, together with the optional template 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
breakpointTemplate - The (optional) template that will be used when new breakpoints are created. This is useful if certain properties of a new breakpoint, such as the condition, have defaults and/or are read-only and should not be editable by the user on creation.

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.

editBreakpoint

boolean editBreakpoint(DebuggerBreakpoint breakpoint)
Called by the DebuggerExtender to ask the Debugger to show the dialog where the user can edit the incoming breakpoint. If the user successfully edited the breakpoint, this method will return true, and the DebuggerExtender will also get called back through DebuggerExtender.breakpointChanged with BreakpointState.EDITED
Parameters:
breakpoint - The breakpoint
Returns:
True if the user exited the dialog with the OK button, false if the breakpoint was not recognized or if the user cancelled the dialog.

getDefaultBreakpointSettings

DebuggerBreakpoint getDefaultBreakpointSettings()
Called by the DebuggerExtender to ask the Debugger for the settings of a 'default' breakpoint. The DebuggerExtender can use this default breakpoint to create a template for custom breakpoints.
Returns:
A 'default' breakpoint

Skip navigation links

Oracle Fusion Middleware Java API Reference for Oracle Extension SDK
11g Release 2 (11.1.2.2.0)

E17493-03


Copyright © 1997, 2012, Oracle. All rights reserved.