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

Page: 952 / 1108

952 Chapter 5: Application.CFC Reference
If an exception occurs while processing the
onError
method, or if the
onError
method uses a
cfthrow
tag, the ColdFusion MX standard error handling mechanisms handle the exception.
These mechanisms include: any error handlers specified by
cferror
tags in the Application.cfc
initialization code, the site-wide error handler specified in the ColdFusion MX Administrator,
and ColdFusion MX default error page. Therefore, you can use the
onError
method as a filter to
handle selected errors, and use other ColdFusion error-handling techniques for the remaining
errors.
Example
<cffunction name="onError">
<cfargument name="Exception" required=true/>
<cfargument type="String" name="EventName" required=true/>
<!--- Log all errors. --->
<cflog file="#This.Name#" type="error"
text="Event Name: #Arguments.Eventname#" >
<cflog file="#This.Name#" type="error"
text="Message: #Arguments.Exception.message#">
<cflog file="#This.Name#" type="error"
text="Root Cause Message: #Arguments.Exception.rootcause.message#">
<!--- Display an error message if there is a page context. --->
<cfif NOT (Arguments.EventName IS "onSessionEnd") OR
(Arguments.EventName IS "onApplicationEnd")>
<cfoutput>
<h2>An unexpected error occurred.</h2>
<p>Please provide the following information to technical support:</p>
<p>Error Event: #Arguments.EventName#</p>
<p>Error details:<br>
<cfdump var=#Arguments.Exception#></p>
</cfoutput>
</cfif>
</cffunction>