|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK 11g Release 2 (11.1.2.0.0) E17493-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface DebuggerWindowProvider
Extensions can add their own debugger windows. The debugger will position
the window and supply notification of various events. A debugger window
needs to be prepared to work during multiple concurrent debugging processes,
and the debugger will call 'setContext' each time the 'active' debugging
process changes.
The preferred way to register a DebuggerWindowProvider:
In an extension.xml file, add the registration as follows:
Use a fully qualified class name of an implementation of
oracle.ide.runner.DebuggerWindowProviderDeclarator for the 'class' 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 Ant StarterFactory">
<jdeveloper-hook xmlns="http://xmlns.oracle.com/jdeveloper/1013/extension">
<debugger-hook>
<debugger-window-provider class="my.company.DebuggerWindowProviderDeclarator" />
</debugger-hook>
</jdeveloper-hook>
</triggers>
</trigger-hooks>
A DebuggerWindowProvider is automatically added as a DebuggerListener
The DebuggerListener callbacks will post notification of debugger events.
Call getSource() on the DebuggerEvent to get a DebuggerEventSource Object,
which can be queried for the Context of the process that caused the event.
Nested Class Summary | |
---|---|
static class |
DebuggerWindowProvider.DebuggerWindowPosition
Defines the position of the window |
Method Summary | |
---|---|
java.awt.Rectangle |
getFloatingPosition()
Called by the debugger to get the preferred floating position IFF the window position is FLOATING. |
DebuggerWindowProvider.DebuggerWindowPosition |
getPosition()
Called by the debugger to get the position of the provided window |
DockableWindow |
getWindow()
Called by the debugger to get the custom debugger window |
boolean |
installByDefault()
Called by the debugger to inquire if the window should be created and installed by default. |
void |
refresh()
Called by the debugger as a courtesy when debugger windows are refreshed. |
void |
setContext(Context context)
Called by the debugger when the active debugging process changes |
void |
setDebuggerDockableLayoutPrefix(java.lang.String prefix)
Called by the debugger BEFORE any call to getWindow(). |
void |
setEvaluator(DebuggerEvaluator evaluator)
Called each time the user changes stackframe or thread, supplying a new evaluator for that thread and stackframe. |
void |
shutDown()
Called by the debugger when the IDE shuts down. |
Methods inherited from interface oracle.ide.runner.DebuggerListener |
---|
debuggerFinished, debuggerResuming, debuggerStarted, debuggerStopping |
Method Detail |
---|
boolean installByDefault()
void setEvaluator(DebuggerEvaluator evaluator)
evaluator
- An evaluator that can be used while the debuggee is stopped.void setContext(Context context)
context
- The context of the new 'active' debugging processvoid refresh()
void setDebuggerDockableLayoutPrefix(java.lang.String prefix)
prefix
- The prefix the debugger uses for layoutsDockableWindow getWindow()
DebuggerWindowProvider.DebuggerWindowPosition getPosition()
java.awt.Rectangle getFloatingPosition()
void shutDown()
|
Oracle Fusion Middleware Java API Reference for Oracle Extension SDK 11g Release 2 (11.1.2.0.0) E17493-01 |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |