ColdFusion Developer's Guide

Beta Beta Beta Beta Beta Beta Beta Beta Beta Beta
Type Type name Description
Application-defined
exception events
raised by cfthrow
Custom exceptions
You can generate an exception with your own type by specifying a custom exception type
name, for example MyCustomErrorType, in a cfthrow tag. You then specify the custom type
name in a cfcatch or cferror tag to handle the exception. Custom type names must be
different from any built-in type names, including basic types and Java exception classes.
Advanced exception types
The Advanced exceptions consist of a set of specific, narrow exception types. These types are
supported in ColdFusion for backward-compatibility. For a list of advanced exception types,
see “Advanced Exception types” in Chapter 3, “ColdFusion Tags,” in CFML Reference.
Java exception classes
Every ColdFusion exception belongs to, and can be identified by, a specific Java exception
class in addition to its basic, custom, or advanced type. The first line of the stack trace in the
standard error output for an exception identifies the exception’s Java class.
For example, if you attempt to use an array function such as ArrayIsEmpty on an integer
variable, ColdFusion generates an exception that belongs to the Expression exception basic
type and the coldfusion.runtime.NonArrayException Java class.
In general, most applications do not need to use Java exception classes to identify exceptions.
However, you can use Java class names to catch exceptions in non-CFML Java objects; for
example, the following line catches all Java input/output exceptions:
Application Custom exceptions generated by a cfthrow
tag that do not specify a type, or specify the
type as Application.
All exceptions Any Any exceptions. Includes all types in this table
and any exceptions that are not specifically
handled in another error handler, including
unexpected internal and external errors.
NOTE
The Any type includes all error with the Java object type of java.lang.Exception. It does
not include java.lang.Throwable errors. To catch Throwable errors, specify
java.lang.Throwable in the cfcatch tag type attribute.
Understanding errors 367