Working with Templates

Templates are user-defined collections of exceptions you want counted during ru ntime. By using templates, the same exceptions are counted during execution of your application, ensuring consistency and accuracy of the count results.

To create a template:

1. In the Templates panel, click Add.

   The Add Template dialog box appears.

2. Enter a name for your template (for example, My Template) and click OK.

   The new template appears on the Templates list (Figure: New Template Added).

To rename a template:

1. Select the template you want to rename.

2. Click Edit.

   The Edit Template dialog box appears.

3. Click OK.

   The renamed template appears on the Templates list.

To delete a template:

1. Select the template you want to delete.

2. Click Delete.

To add exceptions to the template

1. In the Template panel, select the template to which you want to add exceptions.

   The title of the template list changes to match the name of the highlighted template.

   
   

   Note: If the template name is too long, the list name will be truncated.

   
   

2. In the Exception List panel, click Add.

   The Add new exception to profile dialog box appears.

3. Enter the name of the exception class you want to use (for example, java.lang.Exception).

4. If you want to include all subclasses to the specified exception class in the exception count profile, select Include subclasses in the exception count.

5. Click OK.

   The dialog box closes and the new exception class appears in the exception list (Figure: Exception List).

   Exception List

   
   Description of " Exception List"
   
   

6. Select the plus sign (+) next to the class name to expand the list and see all the subclasses for the selected class.

7. Select the checkbox next to each subclass that you want to profile.

   The selected exceptions will be profiled when exception profiling is started, as described in "Profiling Exceptions".

To edit exceptions:

Editing an exception allows you to enable or disable profiling of subclasses. The check box in the tree enables or disables the actual profiling. In the dialog box, you can specify whether or not classes derived from that exception class should be included in the count.

1. Highlight the exception you want to edit.

2. Click Edit.

   The Edit <exception.name> dialog box appears.

3. Do one of the following:

   • To include classes derived from the exception, select the check box.

   • If classes are already included and you want to exclude them, deselect the check box.

4. Click OK.

To remove exceptions from the template:

1. Select the exception class or subclass you want to delete.

2. Click Delete.