org.netbeans.api.debugger.jpda

Class ExceptionBreakpoint

java.lang.Object

org.netbeans.api.debugger.Breakpoint

org.netbeans.api.debugger.jpda.JPDABreakpoint

org.netbeans.api.debugger.jpda.ExceptionBreakpoint

public class ExceptionBreakpoint
extends JPDABreakpoint

Notifies about exceptions throw in debugged JVM.

How to use it:

    DebuggerManager.addBreakpoint (ExceptionBreakpoint.create (
        "java.lang.NullPointerException",
        ExceptionBreakpoint.TYPE_EXCEPTION_UNCATCHED
    ));

This breakpoint stops when NullPointerException is throw and uncatched.

Nested Class Summary

Nested classes/interfaces inherited from class org.netbeans.api.debugger.Breakpoint

Breakpoint.GroupProperties, Breakpoint.HIT_COUNT_FILTERING_STYLE, Breakpoint.VALIDITY

Field Summary

Fields

Modifier and Type	Field and Description
static String	PROP_CATCH_TYPE Property name constant.
static String	PROP_CLASS_EXCLUSION_FILTERS Property name constant
static String	PROP_CLASS_FILTERS Property name constant
static String	PROP_CONDITION Property name constant.
static String	PROP_EXCEPTION_CLASS_NAME Property name constant
static int	TYPE_EXCEPTION_CATCHED Catch type constant.
static int	TYPE_EXCEPTION_CATCHED_UNCATCHED Catch type constant.
static int	TYPE_EXCEPTION_UNCATCHED Catch type constant.

Fields inherited from class org.netbeans.api.debugger.jpda.JPDABreakpoint

PROP_HIDDEN, PROP_PRINT_TEXT, PROP_SUSPEND, SUSPEND_ALL, SUSPEND_EVENT_THREAD, SUSPEND_NONE

Fields inherited from class org.netbeans.api.debugger.Breakpoint

PROP_DISPOSED, PROP_ENABLED, PROP_GROUP_NAME, PROP_GROUP_PROPERTIES, PROP_HIT_COUNT_FILTER, PROP_VALIDITY

Method Summary

Modifier and Type	Method and Description
static ExceptionBreakpoint	create(String exceptionClassName, int catchType) Creates a new breakpoint for given parameters.
int	getCatchType() Returns breakpoint type property value.
String[]	getClassExclusionFilters() Get list of class exclusion filters to stop on.
String[]	getClassFilters() Get list of class filters to stop on.
String	getCondition() Returns condition.
String	getExceptionClassName() Get name of exception class to stop on.
void	setCatchType(int catchType) Sets breakpoint type property value.
void	setClassExclusionFilters(String[] classExclusionFilters) Set list of class exclusion filters to stop on.
void	setClassFilters(String[] classFilters) Set list of class filters to stop on.
void	setCondition(String cond) Sets condition.
void	setExceptionClassName(String cn) Set name of exception class to stop on.
String	toString() Returns a string representation of this object.

Methods inherited from class org.netbeans.api.debugger.jpda.JPDABreakpoint

addJPDABreakpointListener, canHaveDependentBreakpoints, disable, enable, getPrintText, getSession, getSuspend, isEnabled, isHidden, removeJPDABreakpointListener, setHidden, setPrintText, setSession, setSuspend

Methods inherited from class org.netbeans.api.debugger.Breakpoint

addPropertyChangeListener, addPropertyChangeListener, dispose, firePropertyChange, getBreakpointsToDisable, getBreakpointsToEnable, getGroupName, getGroupProperties, getHitCountFilter, getHitCountFilteringStyle, getValidity, getValidityMessage, removePropertyChangeListener, removePropertyChangeListener, setBreakpointsToDisable, setBreakpointsToEnable, setGroupName, setHitCountFilter, setValidity

Methods inherited from class java.lang.Object

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

Field Detail

PROP_EXCEPTION_CLASS_NAME

public static final String PROP_EXCEPTION_CLASS_NAME

Property name constant

See Also:

Constant Field Values

PROP_CLASS_FILTERS

public static final String PROP_CLASS_FILTERS

Property name constant

See Also:

Constant Field Values

PROP_CLASS_EXCLUSION_FILTERS

public static final String PROP_CLASS_EXCLUSION_FILTERS

Property name constant

See Also:

Constant Field Values

PROP_CATCH_TYPE

public static final String PROP_CATCH_TYPE

Property name constant.

See Also:

Constant Field Values

PROP_CONDITION

public static final String PROP_CONDITION

Property name constant.

See Also:

Constant Field Values

TYPE_EXCEPTION_CATCHED

public static final int TYPE_EXCEPTION_CATCHED

Catch type constant. [sic] "caught"

See Also:

Constant Field Values

TYPE_EXCEPTION_UNCATCHED

public static final int TYPE_EXCEPTION_UNCATCHED

Catch type constant. [sic] "uncaught"

See Also:

Constant Field Values

TYPE_EXCEPTION_CATCHED_UNCATCHED

public static final int TYPE_EXCEPTION_CATCHED_UNCATCHED

Catch type constant. [sic] "caught/uncaught"

See Also:

Constant Field Values

Method Detail

create

public static ExceptionBreakpoint create(String exceptionClassName,
                                         int catchType)

Creates a new breakpoint for given parameters.

Parameters:

exceptionClassName - class name filter

catchType - one of constants: TYPE_EXCEPTION_CATCHED, TYPE_EXCEPTION_UNCATCHED, TYPE_EXCEPTION_CATCHED_UNCATCHED

Returns:

a new breakpoint for given parameters

getExceptionClassName

public String getExceptionClassName()

Get name of exception class to stop on.

Returns:

name of exception class to stop on

setExceptionClassName

public void setExceptionClassName(String cn)

Set name of exception class to stop on.

Parameters:

cn - a new name of exception class to stop on.

getClassFilters

public String[] getClassFilters()

Get list of class filters to stop on.

Returns:

list of class filters to stop on

setClassFilters

public void setClassFilters(String[] classFilters)

Set list of class filters to stop on.

Parameters:

classFilters - a new value of class filters property

getClassExclusionFilters

public String[] getClassExclusionFilters()

Get list of class exclusion filters to stop on.

Returns:

list of class exclusion filters to stop on

setClassExclusionFilters

public void setClassExclusionFilters(String[] classExclusionFilters)

Set list of class exclusion filters to stop on.

Parameters:

classExclusionFilters - a new value of class exclusion filters property

getCondition

public String getCondition()

Returns condition.

Returns:

cond a condition

setCondition

public void setCondition(String cond)

Sets condition.

Parameters:

cond - a c new condition

getCatchType

public int getCatchType()

Returns breakpoint type property value.

Returns:

breakpoint type property value.

setCatchType

public void setCatchType(int catchType)

Sets breakpoint type property value.

Parameters:

catchType - a new value of breakpoint type property value

toString

public String toString()

Returns a string representation of this object.

Overrides:

toString in class Object

Returns:

a string representation of the object