Programming ColdFusion

Name

CFTHROW

Synopsis

<CFTHROW>

Creates a custom exception type that can be caught by the CFTRY/CFCATCH tags when the TYPE attribute of the CFCATCH tag is set to Application, Any, or the custom type you specify in the CFTHROW tag.

As of ColdFusion 4.5.x, you can name custom exception types in a hierarchical manor so that you can reference groups of custom exception types with a single CFCATCH tag. Consider the following CFTHROW tag:

<CFTHROW TYPE="MyApp.RequiredParameters.MyVar">

Any of the three following CFCATCH tags can be used to catch the exception:

<CFCATCH TYPE="MyApp.RequiredParameters.MyVar ">
<CFCATCH TYPE="MyApp.RequiredParameters">
<CFCATCH TYPE="MyApp">

Note that this new behavior in CF 4.5.x results in a potential backward compatibility problem with Version 4.01 of ColdFusion. In Version 4.01, a custom exception coded as:

<CFTHROW TYPE="MyApp.RequiredParameters.MyVar">

can only be caught by an identically named CFCATCH tag, as in:

<CFCATCH TYPE="MyApp.RequiredParameters.MyVar">

but not by these:

<CFCATCH TYPE="MyApp.RequiredParameters">  
<CFCATCH TYPE="MyApp">

This behavior can be manually overridden by including the CFSETTING tag in your Application.cfm template with the CATCHEXCEPTIONSBYPATTERN attribute set to No as in:

<!--- this is the Application.cfm template --->
<CFAPPLICATION NAME="MyApplication">
<CFSETTING CATCHEXCEPTIONSBYPATTERN="No">

Attributes

TYPE=" exception_type "

A name for the exception type. You may give the exception type a custom name or use the predefined ...