MACROMEDIA COLDFUSION MX 61-CFML, Reference

Page: 488 / 806

488 Chapter 3: ColdFusion Functions
GetException
Description
Used with the
cftry
and
cfcatch
tags. Retrieves a Java exception object from a Java object.
Returns
Any Java exception object raised by a previous method call on the Java object.
Category
System functions
Syntax
getException ( object )
Parameters
Usage
ColdFusion stores a Java exception object for each method call on a Java object. Subsequent
method calls reset the exception object. To get the current exception object, you must call
GetException
on the Java object before other methods are invoked on it.
Example
<!--- Create the Java object reference --->
<cfobject action = create type = java class = primativetype name = myObj>
<!--- Calls the object's constructor --->
<cfset void = myObj.init()>
<cftry>
<cfset void = myObj.DoException() >
<Cfcatch type = "Any">
<cfset exception = getException(myObj)>
<!--- user can call any valid method on the exception object--->
<cfset message = exception.toString()>
<cfoutput>
Error<br>
I got exception <br>
<br> The exception message is: #message# <br>
</cfoutput>
</cfcatch>
</cftry>
Parameter Description
object A Java object.