User Guide

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.