Overview

Package

Class

Use

Tree

Deprecated

Index

Help

org.netbeans.api.debugger/1 1.26.1

PREV NEXT

FRAMES NO FRAMES

Debugger Core API
Official

The Debugger Core API module defines common structures for integration of debugger implementations into NetBeans IDE.

See:
Description

Debugger Core API
org.netbeans.api.debugger	The NetBeans Debugger Core API definition.
org.netbeans.spi.debugger	The NetBeans Debugger SPI definition defines interface to Debugger Plug-ins.

The Debugger Core API module defines common structures for integration of debugger implementations into NetBeans IDE.
List of APIs:

DebuggerCoreAPI Debugger Core APIs
DebuggerCoreSPI Debugger Core SPIs
Meta-inf-debugger-org.netbeans.api.debugger.Properties-Reader Loads all property readers from given folder.
Meta-inf-debugger-DebuggerInfo-ID-org.netbeans.spi.debugger.SessionProvider Loads all session providers for specific DebuggerInfo.
Meta-inf-debugger-DebuggerInfo-ID-org.netbeans.spi.debugger.DelegatingSessionProvider Loads all delegating session providers for specific DebuggerInfo.
Meta-inf-debugger-DebuggerInfo-ID-org.netbeans.spi.debugger.DebuggerEngineProvider Loads all debugger engine providers for specific DebuggerInfo.
Meta-inf-debugger-DebuggerInfo-ID-org.netbeans.spi.debugger.DelegatingDebuggerEngineProvider Loads all delegating debugger engine providers for specific DebuggerInfo.
Meta-inf-debugger-Session-ID-org.netbeans.spi.debugger.DebuggerEngineProvider Loads all debugger engine providers for specific Session.
Meta-inf-debugger-Session-ID-org.netbeans.spi.debugger.DelegatingDebuggerEngineProvider Loads all delegating debugger engine providers for specific Session.
Meta-inf-debugger-org.netbeans.api.debugger.LazyDebuggerManagerListener Loads all debbugger manager listeners and adds them to DebuggerManager.getDebuggerManager () instance.
Meta-inf-debugger-org.netbeans.spi.debugger.ActionsProvider Loads all action providers for DebuggerManager context.
Meta-inf-debugger-DebuggerEngine-ID-org.netbeans.spi.debugger.ActionsProvider Loads all action providers for DebuggerEngine (language) context.
Meta-inf-debugger-Session-ID-org.netbeans.spi.debugger.ActionsProvider Loads all action providers for Session context.
Meta-inf-debugger-DebuggerInfo-ID-org.netbeans.spi.debugger.ActionsProvider Loads all action providers for DebuggerInfo context.

Registrations in standard Lookup:

org.netbeans.spi.debugger.ContextAwareService Loads all registered context-aware services from given folder.
org.netbeans.spi.debugger.SessionProvider.ContextAware.createService Loads all session providers for specific DebuggerInfo.
org.netbeans.spi.debugger.DebuggerEngineProvider.ContextAware.createService Loads all debugger engine providers for specific DebuggerInfo or Session.
org.netbeans.api.debugger.LazyDebuggerManagerListener.ContextAware.createService Loads all debbugger manager listeners and adds them to DebuggerManager.getDebuggerManager () instance.
org.netbeans.spi.debugger.ActionsProvider.ContextAware.createService Loads all action providers for context determined by it's path.
netbeans.debugger.registration Writes registration log to console.

What is New (see all changes)?

Feb 28 '10 Breakpoints group properties.

Add Breakpoint.getGroupProperties() method, that returns an implementation of GroupProperties class with the relevant grouping information used by BreakpointsWindow to create hierarchy of breakpoint groups
Feb 23 '10 It's possible to override New Watch action with a session-specific provider.

ActionsManager.ACTION_NEW_WATCH constant was added for use by session-specific provider of New Watch action. That action invokes an implementation of ActionsProvider that is registered for the active debugger session and contains ActionsManager.ACTION_NEW_WATCH action.
Feb 11 '10 A declarative mechanism to delay creation of action provider instance until a file with specific MIME type becomes active.

ActionsProvider.Registration annotation is enhanced with two additional methods actions() and activateForMIMETypes(). Until a file with the listed MIME type is selected in the IDE, the appropriate actions provider is left disabled for the given list of actions, without instantiating the implementation class.
Dec 15 '09 Support for changing the order of watches.

createWatch(int index, String expr) and reorderWatches(int[] permutation) methods added to DebuggerManager class.
These methods are going to be called from WatchesTreeModel when watches are reordered.
Feb 28 '09 Support for providing initial values of properties.

Properties.Initializer interface introduced to provide initial values of properties. This is necessary when properties are accessed from more places and it's not practical to copy default values to every such location.
Feb 28 '09 Support for listening to changes of property values.

addPropertyChangeListener() and removePropertyChangeListener() methods added to Properties class.

Use Cases

UseCase I. - Install and use CPP debugger plug-in to NetBeans + Java Debugger.

CPP debugger plug-in installs support for debugging of some new language to the NetBeans IDE, and some new debugging engine. This implementation of debugger should share UI components (actions, Debugger Views, ...) with default NB Java Debugger. It should share basic debugger model too - notion of current context, current session, thread, call stack line, ...

CPP debugger plug-in installs:

New set of breakpoint types - CPPLineBreakpointType, CPPMethodBreakpointType...
- This set of breakpoint types will have special cathegory in Add Breakpoint Dialog called "CPP". Each breakpoint type will install a new JPanel to Add Breakpoint Dialog.
- ToggleBreakpointAction on CPP files will create / remove a instance of CPPLineBreakpointType.
Install some watches evaluator for CPP language.
Some new View to Debugger Window
Use Termilnal Emulator in Output Window as command line interface to CPP debugger plug-in.
Install / uninstall a columns to / from standard Debugger Window Views.
Redefine Nodes used for representation of CPP threads, watches, variables, callstacks, sessions and breakpoints
- Add / remove some properties
- Add / remove some actions
- change icons
- change display names
Register CPP Actions for:
- Step Into, Over, Out, Continue, Pause, Start, Kill, Restart, Finish
Some new CPP specific actions.

UseCase II. - Install and use JSP debugger plug-in to NetBeans + Java Debugger.

JSP debugger plug-in installs support for debugging of some new language to the NetBeans Java Debugger. It does not contain a new debugger engine, but it delegates to standard NB Java debugger. So it does not depends on Debugger Core API only, but it depends on JavaDebugger API too.

JSP debugger plug-in installs:

New set of breakpoint types - JSPLineBreakpointType, ...
- This set of breakpoint types will have special cathegory in Add Breakpoint Dialog called "JSP". Each breakpoint type will install a new JPanel to Add Breakpoint Dialog.
- ToggleBreakpointAction on JSP files will create / remove a instance of JSPLineBreakpointType.
- JSPLineBreakpointType delegates all functionality to JPDAClassBreakpoint and JPDALineBreakpoint
Some watches evaluator for JSP language expression. This evaluator delegates evaluation of Java expressions to standard JavaExpressionEvaluator.
Redefine Nodes used for representation of JSP callstacks and breakpoints
- Add / remove some properties
- Add / remove some actions
- change icons
- change display names
Register JSP Actions for:
- Step Into, Over, Out
- Implementation of this actions delegates to standard Java Step actions - it redefines Java stepping functionality.
JSP debugger plug in adds support for new programming language (JSP) to already running Java Session.

UseCase III. - Install and use J2EE debugger plug-in to NetBeans + Java Debugger.

J2EE debugger plug-in installs some enhancements to the standard Java Debugger. It does not contain a new debugger engine or language support. So it does not depends on Debugger Core API only, but it depends on JavaDebugger API too.

J2EE debugger plug-in installs:

New set of breakpoint types
Filter for Threads and Callstack Views. This filter should allow to:
- Add / remove / modify nodes in this views.
Redefine Stepping (Smart Stepping) behaviour of default Java Debugger.
Some new View to Debugger Window

UseCase IV. - Install and use DBX debugger plug-in to NetBeans.

DBX debugger plug-in installs support for debugging of some new language (CPP) to the NetBeans IDE, and some new debugging engine. But it contains debugger engine for Java debugging too. DBX debugger engine has its own session management (or will have in the next versions). One debugger engine can manage more than one sessions. One engine supports debugging in more than one language.

UseCase V. - Implement Debugger Core UI module on top of Debugger Core API / SPI.

Debugger Core UI needs:

List all breakpoint types and all breakpoint cathegories.
Visually customize all breakpoints - some panel.
Add / remove breakpoints.
Add / remove watches.
Represent breakpoints, threads, thread groups, watches, sessions, call stack frames, locales, and fields as Nodes in NB Explorer View.
List all threads, thread groups, locales, watches, breakpoints, callstack frames, and fields.
Listen on changes of hierarchy of threads, thread groups, locales, watches, breakpoints, callstack frames, and fields.
Some current context definition. Current contet should define current session, language, thread, and call stack line.

Exported Interfaces

This table lists all of the module exported APIs with defined stability classifications. It is generated based on answers to questions about the architecture of the module. Read them all...

Group of java interfaces

Interface Name	In/Out	Stability	Specified in What Document?
DebuggerCoreAPI	Exported	Official	../org-netbeans-api-debugger

Group of lookup interfaces

Interface Name

In/Out

Stability

Specified in What Document?

Group of property interfaces