public interface IJavaBreakpointListener
JDIDebugModel
.
Since 3.5, clients can also register breakpoint listeners using the
org.eclipse.jdt.debug.breakpointListeners
extension point. A
listener can be contributed to receive notifications from all Java
breakpoints or receive notifications about specific breakpoints by
programmatically registering the extension with a breakpoint.
Clients are intended to implement this interface.
JDIDebugModel
,
IJavaBreakpoint
Modifier and Type | Field and Description |
---|---|
static int |
DONT_CARE
Return code indicating that this listener should not be considered in a
vote to suspend a thread or install a breakpoint.
|
static int |
DONT_INSTALL
Return code in response to an "installing" notification, indicating a
vote to not install the associated breakpoint.
|
static int |
DONT_SUSPEND
Return code in response to a "breakpoint hit" notification, indicating a
vote to not suspend (i.e. resume) the associated thread.
|
static int |
INSTALL
Return code in response to an "installing" notification, indicating a
vote to install the associated breakpoint.
|
static int |
SUSPEND
Return code in response to a "breakpoint hit" notification, indicating a
vote to suspend the associated thread.
|
Modifier and Type | Method and Description |
---|---|
void |
addingBreakpoint(IJavaDebugTarget target,
IJavaBreakpoint breakpoint)
Notification that the given breakpoint is about to be added to the
specified target.
|
void |
breakpointHasCompilationErrors(IJavaLineBreakpoint breakpoint,
Message[] errors)
Notification that the given breakpoint has compilation errors in its
conditional expression.
|
void |
breakpointHasRuntimeException(IJavaLineBreakpoint breakpoint,
DebugException exception)
Notification that the given breakpoint had runtime errors in its
conditional expression.
|
int |
breakpointHit(IJavaThread thread,
IJavaBreakpoint breakpoint)
Notification that the given breakpoint has been hit in the specified
thread.
|
void |
breakpointInstalled(IJavaDebugTarget target,
IJavaBreakpoint breakpoint)
Notification that the given breakpoint has been installed in the
specified target.
|
void |
breakpointRemoved(IJavaDebugTarget target,
IJavaBreakpoint breakpoint)
Notification that the given breakpoint has been removed from the
specified target.
|
int |
installingBreakpoint(IJavaDebugTarget target,
IJavaBreakpoint breakpoint,
IJavaType type)
Notification that the given breakpoint is about to be installed in the
specified target, in the specified type.
|
static final int SUSPEND
static final int DONT_SUSPEND
static final int INSTALL
static final int DONT_INSTALL
static final int DONT_CARE
void addingBreakpoint(IJavaDebugTarget target, IJavaBreakpoint breakpoint)
target
- Java debug targetbreakpoint
- Java breakpointint installingBreakpoint(IJavaDebugTarget target, IJavaBreakpoint breakpoint, IJavaType type)
INSTALL
,
the breakpoint will be installed. If there are no votes to install the
breakpoint, there must be at least one DONT_INSTALL
vote to
cancel the installation. If all listeners vote DONT_CARE
,
the breakpoint will be installed by default.target
- Java debug targetbreakpoint
- Java breakpointtype
- the type (class or interface) the breakpoint is about to be
installed in or null
if the given breakpoint is
not installed in a specific type (one of
IJavaClassType
, IJavaInterfaceType
,
or IJavaArrayType
)INSTALL
, DONT_INSTALL
, or
DONT_CARE
void breakpointInstalled(IJavaDebugTarget target, IJavaBreakpoint breakpoint)
target
- Java debug targetbreakpoint
- Java breakpointint breakpointHit(IJavaThread thread, IJavaBreakpoint breakpoint)
SUSPEND
, the thread will suspend. If there
are no votes to suspend the thread, there must be at least one
DONT_SUSPEND
vote to avoid the suspension (resume). If all
listeners vote DONT_CARE
, the thread will suspend by
default.
The thread the breakpoint has been encountered in is now suspended. Listeners may query thread state and perform evaluations. All subsequent breakpoints in this thread will be ignored until voting has completed.
thread
- Java threadbreakpoint
- Java breakpointSUSPEND
,
DONT_SUSPEND
, or DONT_CARE
void breakpointRemoved(IJavaDebugTarget target, IJavaBreakpoint breakpoint)
target
- Java debug targetbreakpoint
- Java breakpointvoid breakpointHasRuntimeException(IJavaLineBreakpoint breakpoint, DebugException exception)
breakpoint
- the breakpointexception
- the debug exception that occurred evaluating the breakpoint's
conditionvoid breakpointHasCompilationErrors(IJavaLineBreakpoint breakpoint, Message[] errors)
breakpoint
- the breakpointerrors
- the compilation errors in the breakpoint's condition
Copyright (c) 2000, 2015 Eclipse Contributors and others. All rights reserved.Guidelines for using Eclipse APIs.