| <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" |
| "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> |
| <!-- |
| |
| Licensed to the Apache Software Foundation (ASF) under one |
| or more contributor license agreements. See the NOTICE file |
| distributed with this work for additional information |
| regarding copyright ownership. The ASF licenses this file |
| to you under the Apache License, Version 2.0 (the |
| "License"); you may not use this file except in compliance |
| with the License. You may obtain a copy of the License at |
| |
| http://www.apache.org/licenses/LICENSE-2.0 |
| |
| Unless required by applicable law or agreed to in writing, |
| software distributed under the License is distributed on an |
| "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY |
| KIND, either express or implied. See the License for the |
| specific language governing permissions and limitations |
| under the License. |
| |
| --> |
| <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr"> |
| <head> |
| <title>Breakpoint Properties: Exception</title> |
| <link rel="stylesheet" href="ide.css" title="Oracle BLAFDoc" type="text/css"/> |
| </head> |
| |
| <body> |
| <p><a id="NetbeansDebuggerBreakpointExceptionJPDA" name="NetbeansDebuggerBreakpointExceptionJPDA"></a></p> |
| <div id="NBCSH2536"><!-- infolevel="all" infotype="General" --><a id="sthref339" name="sthref339"></a> |
| <h1>Breakpoint Properties: Exception</h1> |
| <a name="BEGIN" id="BEGIN"></a> |
| <p>Use to set the properties of an exception breakpoint. |
| <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"> |
| <param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG850"> |
| <param name="text" value="<html><u>How?</u></html>"> |
| <param name="textFontSize" value="medium"> |
| <param name="textColor" value="blue"> |
| </object> |
| </p> |
| |
| <table summary="Descriptions of exception breakpoint properties." dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0"> |
| <col width="35%" /> |
| <col width="*" /> |
| <thead> |
| <tr align="left" valign="top"> |
| <th align="left" valign="bottom" id="r1c1-t3">Element</th> |
| <th align="left" valign="bottom" id="r1c2-t3">Description</th> |
| </tr> |
| </thead> |
| <tbody> |
| <tr align="left" valign="top"> |
| <td align="left" id="r2c1-t3" headers="r1c1-t3"> |
| <p>Settings</p> |
| </td> |
| <td align="left" headers="r2c1-t3 r1c2-t3">Breakpoint properties (class file and triggers)</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r3c1-t3" headers="r1c1-t3"> |
| <p> Exception Class Name</p> |
| </td> |
| <td align="left" headers="r3c1-t3 r1c2-t3">Specifies the full class name of the exception or error.</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r4c1-t3" headers="r1c1-t3"> |
| <p> Stop on</p> |
| </td> |
| <td align="left" headers="r4c1-t3 r1c2-t3">Specifies when to trigger the breakpoint. The breakpoint can be triggered when the exception is caught, when the exception is not caught, or on all exceptions (exception caught or uncaught).</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r5c1-t3" headers="r1c1-t3"> |
| <p>Conditions</p> |
| </td> |
| <td align="left" headers="r5c1-t3 r1c2-t3">Conditional expression for the breakpoint</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r6c1-t3" headers="r1c1-t3"> |
| <p> Filter on Classes Throwing the Exception</p> |
| </td> |
| <td align="left" headers="r6c1-t3 r1c2-t3">Filters the classes that trigger the breakpoint. You can specify that only exceptions occurring in classes matching a specific class name can trigger the breakpoint. You can also specify that exceptions occurring in specified classes do not trigger the breakpoint. |
| <p>You can use an asterisk (<code dir="ltr">*</code>) as a suffix to specify more than one class. For example, specify <code dir="ltr">java.lang*</code> to specify all classes from the package java.lang. You can specify multiple patterns by separating the patterns with a comma or a space (<code dir="ltr">java.net.URLClassLoader*, java.lang.ClassLoader</code>).</p> |
| </td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r7c1-t3" headers="r1c1-t3"> |
| <p> Condition</p> |
| </td> |
| <td align="left" headers="r7c1-t3 r1c2-t3">Uses a Boolean expression to trigger the breakpoint when the expression evaluates to True. |
| <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"> |
| <param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG856"> |
| <param name="text" value="<html><u>More</u></html>"> |
| <param name="textFontSize" value="medium"> |
| <param name="textColor" value="blue"> |
| </object> |
| </td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r8c1-t3" headers="r1c1-t3"> |
| <p> Break when hit count</p> |
| </td> |
| <td align="left" headers="r8c1-t3 r1c2-t3">Enables you to specify how frequently the breakpoint is triggered. Choose a criteria in the drop-down list and then specify a numerical value.</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r9c1-t3" headers="r1c1-t3"> |
| <p>Actions</p> |
| </td> |
| <td align="left" headers="r9c1-t3 r1c2-t3">Actions to take when the breakpoint is triggered.</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r10c1-t3" headers="r1c1-t3"> |
| <p> Suspend</p> |
| </td> |
| <td align="left" headers="r10c1-t3 r1c2-t3">Specifies which threads in the program being debugged are suspended when the breakpoint is reached. You can specify no threads, all threads, or the breakpoint thread. The breakpoint thread is the thread that is current when the breakpoint is reached.</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r11c1-t3" headers="r1c1-t3"> |
| <p> Enable Group</p> |
| </td> |
| <td align="left" headers="r11c1-t3 r1c2-t3">Enables all the breakpoints in the selected group. The dropdown list contains all named groups and default groups of breakpoints organized by file, project and type. |
| <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"> |
| <param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG859"> |
| <param name="text" value="<html><u>More</u></html>"> |
| <param name="textFontSize" value="medium"> |
| <param name="textColor" value="blue"> |
| </object> |
| |
| <p>For more about named breakpoint groups, see Organizing Breakpoints Into a Group.</p> |
| </td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r12c1-t3" headers="r1c1-t3"> |
| <p> Disable Group</p> |
| </td> |
| <td align="left" headers="r12c1-t3 r1c2-t3">Disables all the breakpoints in the selected group.</td> |
| </tr> |
| <tr align="left" valign="top"> |
| <td align="left" id="r13c1-t3" headers="r1c1-t3"> |
| <p> Print Text</p> |
| </td> |
| <td align="left" headers="r13c1-t3 r1c2-t3">Prints the specified message in the Debugger Console view of the Output window. |
| <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"> |
| <param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG2218"> |
| <param name="text" value="<html><u>More</u></html>"> |
| <param name="textFontSize" value="medium"> |
| <param name="textColor" value="blue"> |
| </object> |
| </td> |
| </tr> |
| </tbody> |
| </table> |
| <br /> |
| <!-- --> |
| <a id="NBCSH2549" name="NBCSH2549"></a> |
| <hr><p><b>Related Topics</b></p> |
| <p><i>Developing Applications with NetBeans IDE</i>, |
| <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"> |
| <param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG847"> |
| <param name="text" value="<html><u>"Managing Breakpoints"</u></html>"> |
| <param name="textFontSize" value="medium"> |
| <param name="textColor" value="blue"> |
| </object> |
| </p> |
| <p>Developing Applications with NetBeans IDE, |
| <object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer"> |
| <param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG822"> |
| <param name="text" value="<html><u>"Using Debugger Windows"</u></html>"> |
| <param name="textFontSize" value="medium"> |
| <param name="textColor" value="blue"> |
| </object> |
| </p> |
| |
| <!-- --> |
| <!-- Start Footer --> |
| |
| |
| <table summary="" cellspacing="0" cellpadding="0" width="100%"> |
| <tr> |
| <td align="left" width="86%"><a href="legal_notice.htm"> |
| Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.</a> |
| </td> |
| </tr> |
| </table> |
| <!-- --> |
| </body> |
| </html> |
