Eclipse
Eclipse
IDEA
IntelliJ
NetBeans
NetBeans
XpoLog
XpoLog
org.eclipse.jdt.debug.core
Interface IJavaBreakpointListener
Tab mode
public interface IJavaBreakpointListener
Provides event and error notification for Java breakpoints. Listeners register with the JDIDebugModel.

Clients are intended to implement this interface.

Since2.0
VersionNot specified.
AuthorNot specified.
Wiki javadoc Use textile entry format.
Add your comments here.
Field Summary
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.
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.
Method Summary
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.
Field Detail
DONT_CARE
public 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.
Since: 3.0
Wiki javadoc Use textile entry format.
Add your comments here.
DONT_INSTALL
public static int DONT_INSTALL
Return code in response to an "installing" notification, indicating a vote to not install the associated breakpoint.
Since: 3.0
Wiki javadoc Use textile entry format.
Add your comments here.
DONT_SUSPEND
public 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.
Since: 3.0
Wiki javadoc Use textile entry format.
Add your comments here.
INSTALL
public static int INSTALL
Return code in response to an "installing" notification, indicating a vote to install the associated breakpoint.
Since: 3.0
Wiki javadoc Use textile entry format.
Add your comments here.
SUSPEND
public static int SUSPEND
Return code in response to a "breakpoint hit" notification, indicating a vote to suspend the associated thread.
Since: 3.0
Wiki javadoc Use textile entry format.
Add your comments here.
Method Detail
addingBreakpoint
public void addingBreakpoint ( IJavaDebugTarget target, IJavaBreakpoint breakpoint )
Notification that the given breakpoint is about to be added to the specified target. This message is sent before the breakpoint is actually added to the debut target (i.e. this is a pre-notification).
Parameters
TypeNameDescription
IJavaDebugTarget target Java debug target
IJavaBreakpoint breakpoint Java breakpoint
Returns void No description provided.
Wiki javadoc Use textile entry format.
Add your comments here.
breakpointHasCompilationErrors
public void breakpointHasCompilationErrors ( IJavaLineBreakpoint breakpoint, Message [] errors )
Notification that the given breakpoint has compilation errors in its conditional expression.
Parameters
TypeNameDescription
IJavaLineBreakpoint breakpoint the breakpoint
Message [] errors the compilation errors in the breakpoint's condition
Returns void No description provided.
Wiki javadoc Use textile entry format.
Add your comments here.
breakpointHasRuntimeException
public void breakpointHasRuntimeException ( IJavaLineBreakpoint breakpoint, DebugException exception )
Notification that the given breakpoint had runtime errors in its conditional expression.
Parameters
TypeNameDescription
IJavaLineBreakpoint breakpoint the breakpoint
DebugException exception the debug exception that occurred evaluating the breakpoint's condition
Returns void No description provided.
Wiki javadoc Use textile entry format.
Add your comments here.
breakpointHit
public int breakpointHit ( IJavaThread thread, IJavaBreakpoint breakpoint )
Notification that the given breakpoint has been hit in the specified thread. Allows this listener to vote to determine if the given thread should be suspended in reponse to the breakpoint. If at least one listener votes to 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.
Since: 3.0
Parameters
TypeNameDescription
IJavaThread thread Java thread
IJavaBreakpoint breakpoint Java breakpoint
Wiki javadoc Use textile entry format.
Add your comments here.
breakpointInstalled
public void breakpointInstalled ( IJavaDebugTarget target, IJavaBreakpoint breakpoint )
Notification that the given breakpoint has been installed in the specified target.
Parameters
TypeNameDescription
IJavaDebugTarget target Java debug target
IJavaBreakpoint breakpoint Java breakpoint
Returns void No description provided.
Wiki javadoc Use textile entry format.
Add your comments here.
breakpointRemoved
public void breakpointRemoved ( IJavaDebugTarget target, IJavaBreakpoint breakpoint )
Notification that the given breakpoint has been removed from the specified target.
Parameters
TypeNameDescription
IJavaDebugTarget target Java debug target
IJavaBreakpoint breakpoint Java breakpoint
Returns void No description provided.
Wiki javadoc Use textile entry format.
Add your comments here.
installingBreakpoint
public 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. Allows this listener to vote to determine if the given breakpoint should be installed in the specified type and target. If at least one listener votes to 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.
Since: 3.0
Parameters
TypeNameDescription
IJavaDebugTarget target Java debug target
IJavaBreakpoint breakpoint Java breakpoint
IJavaType type 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)
Wiki javadoc Use textile entry format.
Add your comments here.