User Guide

JavaCast 703

JavaCast

Description

Converts the data type of a ColdFusion variable to pass as an argument to an overloaded method

of a Java object. Use only for scalar and string arguments.

Returns

The variable, as type type.

See also

CreateObject

, cfobject

Parameters

Usage

Use after creating a Java object with the cfobject tag, before calling one of its methods. If the

method takes more than one overloaded argument, you must call

JavaCast for each one. Use

JavaCast only when a method is overloaded (because its arguments can take more than one data

type, not because the method can take a variable number of arguments).

JavaCast cannot be used to cast between complex objects, nor to cast to a super-class.

Use the result of this function only on calls to Java objects, as shown in the following example:

x = CreateObject("java", "test.Hello");

x.init();

ret = x.sayHello(JavaCast("null", ""));

</cfscript>

Warning: Do not assign the results of

JavaCast("null","") to a ColdFusion variable. Unexpected

results will occur.

Parameter Description

type Data type to which to convert variable:

• boolean

• int

• long

• float

• double

• string

• null

variable A ColdFusion variable that holds a scalar or string type. Must be

"" if type is null.