MACROMEDIA COLFUSION MX 7 - INSTALLING AND USING COLDFUSION MX, Reference

Page: 61 / 1108

cfcatch 61
Attributes
Usage
You must code at least one
cfcatch
tag within a
cftry
block. Put
cfcatch
tags at the end of a
cftry
block. ColdFusion MX tests
cfcatch
tags in the order in which they appear. This tag
requires an end tag.
If
type="any"
, ColdFusion MX catches exceptions from any CFML tag, data source, or external
object. To get the exception type use code such as the following:
#cfcatch.type#
Applications can use the
cfthrow
tag to throw developer-defined exceptions. Catch these
exceptions with any of these
type
options:
•
" custom_type "
•
"Application"
•
"Any"
The
custom_type
type is a developer-defined type specified in a
cfthrow
tag. If you define a
custom type as a series of strings concatenated by periods (for example,
"
MyApp.BusinessRuleException.InvalidAccount
"), ColdFusion MX can catch the custom
type by its character pattern. ColdFusion MX searches for a
cfcatch
tag in the
cftry
block with
a matching exception type, starting with the most specific (the entire string), and ending with the
least specific.
For example, you could define a type as follows:
<cfthrow type = "MyApp.BusinessRuleException.InvalidAccount">
If you have the following
cfcatch
tag, it will handle the exception:
<cfcatch type = "MyApp.BusinessRuleException.InvalidAccount">
Otherwise, if you have the following
cfcatch
tag, it will handle the exception:
<cfcatch type = "MyApp.BusinessRuleException">
Finally, if you have the following
cfcatch
tag, it will handle the exception:
<cfcatch type = "MyApp">
Attribute Req/Opt Default Description
type Optional Any
•
application: catches application exceptions
•
database: catches database exceptions
•
template: catches ColdFusion page exceptions
• security: catches security exceptions
• object: catches object exceptions
• missingInclude: catches missing include file exceptions
• expression: catches expression exceptions
• lock: catches lock exceptions
• custom_type : catches the specified custom exception type
that is defined in a
cfthrow
tag
• searchengine: catches Verity search engine exceptions
• any: catches all exception types