Table of Contents
Advertisement
DEVELOPING COLDFUSION 9 APPLICATIONS
Developing CFML Applications
ColdFusion exception types
ColdFusion exceptions have types that you specify in the
or
tag handles only exceptions of the specified type. You identify an exception type by using an
cferror
cfcatch
identifier from one (or more) of the following type categories:
• Basic
• Custom
• Advanced
• Java class
Note: Use only custom error type names and the
exception type names identify specific types of system-identified errors, so do not use them for errors that you identify
yourself.
Basic exception types
All ColdFusion exceptions except for custom exceptions belong to a basic type category. These types consist of a
broadly defined categorization of ColdFusion exceptions. The following table describes the basic exception types:
Type
Database failures
Missing include file errors
Template errors
Object exceptions
Security exceptions
Expression exceptions
Locking exceptions
Verity Search engine exception
Application-defined exception
events raised by
cfthrow
All exceptions
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
cferror
Application
Type name
Database
MissingInclude
Template
Object
Security
Expression
Lock
SearchEngine
Application
Any
Last updated 8/5/2010
,
, and
cfcatch
cfthrow
basic type name in
cfthrow
Description
Failed database operations, such as failed SQL statements, ODBC
problems, and so on.
Errors where files specified by the cfinclude, cfmessagebox, and cferror
tags are missing. (A
cferror
tag generates a missingInclude error
only when an error of the type specified in the tag occurs.)
The
MissingInclude
error type is a subcategory of Template error. If
you do not specifically handle the MissingInclude error type, but do
handle the Template error type, the Template error handler catches
these errors.
MissingInclude
errors are caught at runtime.
General application page errors, including invalid tag and attribute
names. Most
errors are caught at compile time, not
Template
runtime.
Exceptions in ColdFusion code that works with objects.
Catchable exceptions in ColdFusion code that works with security.
Failed expression evaluations; for example, if you try to add 1 and "a".
Failed locking operations, such as when a cflock critical section times
out or fails at runtime.
Exceptions generated by the Verity search engine when processing
, cfcollection, or cfsearch tags.
cfindex
Custom exceptions generated by a cfthrow tag that do not specify a
type, or specify the type as
Application
Any exceptions. Includes all types in this table and any exceptions that
are not handled in another error handler, including unexpected
internal and external errors.
error-handling tags. A
tags. All other built-in
.
tag
attribute.
cfcatch
type
278
Advertisement
Table of Contents
