User Guide

554 Chapter 3: ColdFusion Functions
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.
Category
String functions
Function syntax
JavaCast(type, variable)
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 this
function’s result only on calls to Java objects. Because there is not a one-to-one correspondence
between internally stored ColdFusion types and Java scalar types, some conversions cannot be
performed.
Example
The method fooMethod in the class fooClass takes one overloaded argument. The fooClass class
is defined as follows:
public class fooClass {
public fooClass () {
}
public String fooMethod(String arg) {
return "Argument was a String";
}
public String fooMethod(int arg) {
return "Argument was an Integer";
}
Parameter Description
type Data type to which to convert variable:
• boolean
• int
• long
• float
• double
• string
variable A ColdFusion variable that holds a scalar or string type