| <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"> |
| <html> |
| <head> |
| <meta name="copyright" content="Copyright (c) IBM Corporation and others 2000, 2007. This page is made available under license. For full details see the LEGAL in the documentation book that contains this page." > |
| <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1"> |
| <meta http-equiv="Content-Style-Type" content="text/css"> |
| <link rel="stylesheet" href="../book.css" charset="ISO-8859-1" type="text/css"> |
| <title> |
| Adding Line Breakpoints |
| </title> |
| </head> |
| <body> |
| <h1> |
| Create Exception Breakpoint Filtering </h1> |
| <p> |
| Type name and package name filtering can be set up for Java exception breakpoints. This can be done from an exception breakpoints' <strong>Filtering</strong> properties page, as shown in the following figure.</p> |
| <p><img src="../tasks/images/tasks-excetpion-filtering-page.PNG" alt="Java Breakpoint Exception Filtering Properties Page"></p> |
| <p>Using the Filtering properties page there are four ways to add filtering for a Java exception breakpoint:</p> |
| <ol> |
| <li>You can select specific threads to restrict the breakpoint to (which must be done while in a debug session)</li> |
| <li>You can use the <strong>Add Class</strong> button to select a class via the <a href="../reference/ref-148a.htm">Type Selection Dialog</a></li> |
| <li>You can use the <strong>Add Package</strong> button to select a package using a filtered <a href="../reference/ref-148a.htm">Type Selection Dialog</a></li> |
| <li>You can use the<strong> Add </strong>button to define your own pattern to match as a class and/or package filter</li> |
| </ol> |
| <h2>Defining Your Own Filter Pattern</h2> |
| <p>Using the Add button mentioned above, you can define your own pattern to be used as a filter for a Java exception breakpoint. Once pressed, you can then<br> |
| enter any expression in the new space in the <strong>Selected Locations</strong> list, as shown in the following figure.</p> |
| <p><img src="../tasks/images/tasks-exception-filtering-add.PNG" alt="Add Filter Pattern"></p> |
| <p>There are some rules to follow when creating your own pattern.</p> |
| <ol> |
| <li>Your pattern can only contain a '*' at the end </li> |
| <li>Your pattern must be fully qualified, E.g. <em>a.b.c.MyClass</em> </li> |
| <li>Your pattern cannot have spaces in it </li> |
| </ol> |
| <h2>Examples</h2> |
| <ul> |
| <li><em>a.b.c*</em> - would match everything in the package a.b.c</li> |
| <li><em>a.b.c.My* - </em> would match anything in the a.b.c package that started with 'My' </li> |
| <li><em>My*</em> - would match anything in the default package that started with 'My' </li> |
| </ul> |
| <p> </p> |
| </body> |
| </html> |
| |