User Guide

Table Of Contents
118 Chapter 6: Using Flash Remoting with ColdFusion MX
To simplify the debugging of your ColdFusion code, use the cftry and cfcatch tags in your
ColdFusion page or component to catch errors and return helpful error messages about the errors
to the Flash application. For example, the ColdFusion page causeError.cfm contains the following
code:
<cftry>
<cfset dev = Val(0)>
<cfset Flash.Result = (1 / dev)>
<cfcatch type="any">
<cfthrow message="An error occurred in this service: #cfcatch.message#">
</cfcatch>
</cftry>
In this example, the second cfset tag fails because it causes a divide-by-zero error. The message
attribute of the
cfthrow tag describes the error; ColdFusion returns this attribute to the Flash
application. For more information on using the
cftry and cfcatch tags, see Developing
ColdFusion MX Applications with CFML.
To handle the error in your Flash application, you create a fault handler for the
causeError()
method, as follows:
import mx.rpc.FaultEvent;
//…
function causeError_Fault ( fault:FaultEvent ):Void
{
resultBox.text = fault.fault.faultstring;
}
In this example, resultBox is a Flash text box that displays the error message created by the
cfthrow tag.
For more information on handling errors, see Chapter 2, “Using Flash Remoting ActionScript,
on page 29.