Breakpoint Properties dialog box

Use the Breakpoint Properties dialog box to add breakpoints and modify breakpoint properties. The contents and title of the dialog box vary depending on what type of breakpoint you're working with:

Breakpoint Type Description Dialog Box Title When Adding Dialog Box Title When Modifying
Line A line breakpoint is set on a particular line of source code. The debugger stops on that line. Add Line Breakpoint dialog box Breakpoint Properties dialog box
Exception An exception breakpoint causes the debugger to stop at the location when the specified exception is about to be thrown. Add Exception Breakpoint dialog box Breakpoint Properties dialog box
Class A class breakpoint causes the debugger to stop when the specified class is loaded or when any method from the specified class is called. Add Class Breakpoint dialog box Breakpoint Properties dialog box
Method A method breakpoint causes the debugger to stop when the specified method in the specified class is called. Add Method Breakpoint dialog box Breakpoint Properties dialog box
Cross-Process A cross-process breakpoint causes the debugger to stop when you step into the breakpoint. Add Cross-Process Breakpoint dialog box Breakpoint Properties dialog box

Note: Class, method, exception, and field breakpoints are features of JBuilder Professional and Enterprise. Cross-process breakpoints are features of JBuilder Enterprise.

To display this dialog box in add mode,

To modify a breakpoint, right-click a breakpoint in the Data and code breakpoints view and choose Breakpoint Properties.

Top of dialog

The fields in the top of the dialog box depend on what type of breakpoint you're adding or modifying:

For Line Breakpoints

Class Name
The name of the class in which the line breakpoint will be set. Click the ellipsis button button to choose a class.
File Name
The name of the file in which the line breakpoint will be set - a breakpoint can be set in a file that is not a .class file. Click the ellipsis button to choose a file.
Line Number
The number of the line to set the breakpoint on.

For Class Breakpoints

Class Name
The name of the class to set the breakpoint on. Click the ellipsis button to choose a class.

For Exception Breakpoints

Class Name
The name of the exception class to set the breakpoint on. Click the ellipsis button to choose a class.
Caught
Forces the debugger to stop when the exception is caught. (Both Caught and Uncaught can be selected.)
Uncaught
Forces the debugger to stop when the exception is not caught.

For Method Breakpoints

Class Name
The name of the class where the method to break on is defined. Click the ellipsis button to choose a class.
Method Name
The name of the method to break on. Click the ellipsis button to choose a method.
Method Arguments
The method arguments, separate by commas (for overloaded methods).

For Cross-Process Breakpoints

Class Name
The name of the server-side class that contains the method the debugger will break on. Click the ellipsis button to choose a class.
Method Name
The name of the method to break on. Click the ellipsis button to choose a method.
Method Arguments
The method arguments, separate by commas (for overloaded methods).

Bottom of dialog

Fields at the bottom of the dialog box is the same for all breakpoint types:

Actions

The Action for the breakpoint.

Stop Execution
The debugger stops program execution when it hits the breakpoint.
Log Message
The debugger logs the message in the Evaluate Expression field to the Console output, input, and errors view when it hits the breakpoint. You can choose to stop program execution when an expression is evaluated, by choosing the Stop Execution option.
Evaluate Expression
The expression to evaluate when the debugger hits the breakpoint. Expression results are written to the Console output, input, and errors view. The expression can be any valid Java language statement.
Only Log Expression
The debugger logs only the expression to the Console output, input and errors view, and continues running.

For more information, see "Setting breakpoint actions" in Building Applications with JBuilder.

Condition

The condition, if one exists, for this breakpoint. This is an expression that is evaluated each time the breakpoint is encountered during the program execution. The condition must be boolean, that is, it must evaluate to either true or false.

For more information, see "Creating conditional breakpoints" in Building Applications with JBuilder.

Pass Count

The number of times this breakpoint must be passed in order for the breakpoint to be activated.

For more information, see "Using pass count breakpoints" in Building Applications with JBuilder.

See also