Java Breakpoint Listeners

Identifier:
org.eclipse.jdt.debug.breakpointListeners

Since:
3.5

Description:
Allow clients to contribute listeners for Java breakpoint notifications. For example, listeners are called when a breakpoint is hit and about to suspend execution. The listener can vote to resume or suspend the debug session. Listeners can be programmatically added to and removed from specific Java breakpoints (specified by breakpoint listener identifers), or be registered to listen for notifications for all Java breakpoints.

Configuration Markup:

<!ELEMENT extension (breakpointListener)+>

<!ATTLIST extension

point CDATA #REQUIRED

id    CDATA #IMPLIED

name  CDATA #IMPLIED>


<!ELEMENT breakpointListener EMPTY>

<!ATTLIST breakpointListener

id     IDREF #REQUIRED

class  CDATA #REQUIRED

filter (*) >


Examples:
The following is an example for defining a breakpoint listener. In this example, the listener is only notified of breakpoint events for the specific breakpoints it is programatically registered for.


<extension
       point="org.eclipse.jdt.debug.breakpointListeners">
   <breakpointActionDelegate
          class="com.example.BreakpointActionDelegate"
          id="com.example.breakpoint.action">
    </breakpointActionDelegate>
</extension>

API Information:

  • Value of the attribute class in a breakpointListener element must be a fully qualifed name of a Java class that implements org.eclipse.jdt.debug.core.IJavaBreakpointListener.
  • Listeners are added to and removed from a breakpoint programmatically. See IJavaBreakpoint.addBreakpointListener(String id) and IJavaBreakpoint.removeBreakpointListener(String id)

  • Supplied Implementation:
    None


    Copyright (c) 2009 IBM Corporation and others.
    All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v1.0 which accompanies this distribution, and is available at http://www.eclipse.org/legal/epl-v10.html