MACROMEDIA COLFUSION MX 7-CFML, Справочник

Страница: 703 / 1108

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 .
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 the result of this function only on calls to Java objects, as shown in the following example:
<cfscript>
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.