Managing conditional breakpoints
A conditional expression can be applied to a line breakpoint or a watchpoint such that the
breakpoint suspends execution of a thread in one of these cases:
- when the result of the expression is true
- when the result of the expression changes
A conditional expression can contain arbitrary Java code and may contain more than one statement, allowing breakpoint conditions to implement features like tracing. For example, a condition can execute a print statement and then return a hard coded value to never suspend ("
System.out.println(...); return false;").
To set a condition on a breakpoint:
Find the breakpoint to which an enabling condition is to be applied (in
the Breakpoints View or in the editor marker bar).
From the breakpoint's pop-up menu, select Breakpoint
Properties.... The Breakpoint properties dialog will open.
- In the properties dialog, check the Enable Condition checkbox.
- In the Condition field enter the expression for
the breakpoint condition.
- Do one of the following:
- If you want the breakpoint to stop every time the condition evaluates
to true, select the condition is 'true' option.
The expression provided must be a boolean expression.
- If you want the breakpoint to stop only when the result of the
condition changes, select the value of condition changes option.
- Select OK to close the dialog and commit the changes. While
the breakpoint is enabled, thread execution suspends before that line of code
is executed if the breakpoint condition evaluates to true.
A conditional breakpoint has a question mark overlay on the breakpoint icon.
Applying hit counts
Catching Java exceptions
Setting method breakpoints
Stepping through the execution of a program