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, 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>