org.netbeans.api.debugger

Class ActiveBreakpoints

java.lang.Object

org.netbeans.api.debugger.ActiveBreakpoints

public final class ActiveBreakpoints
extends Object

This class handles an engine-related breakpoints activation/deactivation, which is independent on their enabled/disabled state.

Since:

1.51

Field Summary

Fields

Modifier and Type	Field and Description
static String	PROP_BREAKPOINTS_ACTIVE Property change fired when breakpoints activation/deactivation changes.

Method Summary

Modifier and Type	Method and Description
void	addPropertyChangeListener(PropertyChangeListener l) Add a property change listener to be notified about properties defined as PROP_* constants.
boolean	areBreakpointsActive() Test if the engine's breakpoints are currently active.
boolean	canDeactivateBreakpoints() Test if breakpoint deactivation is supported.
static ActiveBreakpoints	get(DebuggerEngine debuggerEngine) Get an ActiveBreakpoints instance for a debugger engine.
void	removePropertyChangeListener(PropertyChangeListener l) Remove a property change listener.
void	setBreakpointsActive(boolean active) Activate or deactivate breakpoints handled by this debugger engine.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

PROP_BREAKPOINTS_ACTIVE

public static final String PROP_BREAKPOINTS_ACTIVE

Property change fired when breakpoints activation/deactivation changes.

See Also:

Constant Field Values

Method Detail

get

public static ActiveBreakpoints get(DebuggerEngine debuggerEngine)

Get an ActiveBreakpoints instance for a debugger engine.

Parameters:

debuggerEngine - the debugger engine.

Returns:

The ActiveBreakpoints instance, that delegates to an BreakpointsActivationProvider provided in it's lookup.

canDeactivateBreakpoints

public boolean canDeactivateBreakpoints()

Test if breakpoint deactivation is supported. When false is returned, ActiveBreakpoints.setBreakpointsActive(boolean) throws UnsupportedOperationException when called with false argument.

Returns:

true when engine-related breakpoints can be deactivated, false otherwise.

areBreakpointsActive

public boolean areBreakpointsActive()

Test if the engine's breakpoints are currently active.

Returns:

true when breakpoints are active, false otherwise.

setBreakpointsActive

public void setBreakpointsActive(boolean active)
                          throws UnsupportedOperationException

Activate or deactivate breakpoints handled by this debugger engine. The breakpoints activation/deactivation is independent on breakpoints enabled/disabled state.

Parameters:

active - true to activate breakpoints, false to deactivate them.

Throws:

UnsupportedOperationException - when there is an attempt to deactivate breakpoints even though ActiveBreakpoints.canDeactivateBreakpoints() return false

addPropertyChangeListener

public final void addPropertyChangeListener(PropertyChangeListener l)

Add a property change listener to be notified about properties defined as PROP_* constants.

Parameters:

l - a property change listener

removePropertyChangeListener

public final void removePropertyChangeListener(PropertyChangeListener l)

Remove a property change listener.

Parameters:

l - a property change listener