org.eclipse.jdt.debug.core
Interface IJavaBreakpointListener

public interface IJavaBreakpointListener

Provides event and error notification for Java breakpoints. Listeners register with the JDIDebugModel.

Clients are intended to implement this interface.

Since:

2.0

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.
boolean	breakpointHit(IJavaThread thread, IJavaBreakpoint breakpoint) Notification that the given breakpoint has been hit in the specified thread - returns whether the thread should suspend.
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.
boolean	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.

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:

target - Java debug target

breakpoint - Java breakpoint

installingBreakpoint

public boolean 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. Returns whether the installation should proceed. If any registered listener returns false the breakpoint is not installed in the given target for the given type.

Parameters:

target - Java debug target

breakpoint - Java breakpoint

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)

Returns:

whether the the breakpoint should be installed in the given type and target

breakpointInstalled

public void breakpointInstalled(IJavaDebugTarget target,
                                IJavaBreakpoint breakpoint)

Notification that the given breakpoint has been installed in the specified target.

Parameters:

target - Java debug target

breakpoint - Java breakpoint

breakpointHit

public boolean breakpointHit(IJavaThread thread,
                             IJavaBreakpoint breakpoint)

Notification that the given breakpoint has been hit in the specified thread - returns whether the thread should suspend. This allows the listener to override default thread suspension when a breakpoint is hit. If at least one listener returns true, the breakpoint will cause the thread to suspend.

Parameters:

thread - Java thread

breakpoint - Java breakpoint

Returns:

whether the thread should suspend

breakpointRemoved

public void breakpointRemoved(IJavaDebugTarget target,
                              IJavaBreakpoint breakpoint)

Notification that the given breakpoint has been removed from the specified target.

Parameters:

target - Java debug target

breakpoint - Java breakpoint

breakpointHasRuntimeException

public void breakpointHasRuntimeException(IJavaLineBreakpoint breakpoint,
                                          DebugException exception)

Notification that the given breakpoint had runtime errors in its conditional expression.

Parameters:

breakpoint - the breakpoint

breakpointHasCompilationErrors

public void breakpointHasCompilationErrors(IJavaLineBreakpoint breakpoint,
                                           Message[] errors)

Notification that the given breakpoint has compilation errors in its conditional expression.

Parameters:

breakpoint - the breakpoint

errors - the compilation errors in the breakpoint's condition