User Guide

Creating and using CORBA objects 963
Using CORBA objects in ColdFusion
After you create the object, you can invoke attributes and operations on the object using the
syntax described in “Creating and using objects” on page 947. The following sections describe the
rules for using CORBA objects in ColdFusion pages. They include information on using
methods in ColdFusion, which IDL types you can access from ColdFusion, and the ColdFusion
data types that correspond to the supported IDL data types.
• Using CORBA interface methods in ColdFusion
• Using IDL types with ColdFusion variables
Using CORBA interface methods in ColdFusion
When you use the
cfobject tag or the CreateObject function to create a CORBA object,
ColdFusion creates a handle to a CORBA interface, which is identified by the
cfobject name
attribute or the
CreateObject function return variable. For example, the following CFML
creates a handle named myHandle:
<cfobject action = "create" type = "CORBA" context = "IOR"
class = "d:\temp\tester.ior" name = "myHandle" locale="visibroker">
<cfset myHandle = CreateObject("CORBA", "d:\temp\tester.ior", "IOR",
"visibroker")
You use the handle name to invoke all of the interface methods, as in the following CFML:
<cfset ret=myHandle.method(foo)>
The following sections describe how to call CORBA methods correctly in ColdFusion.
Method name case considerations
Method names in IDL are case-sensitive. However, ColdFusion is case-insensitive. Therefore, do
not use methods that differ only in case in IDL.
For example, the following IDL method declarations correspond to two different methods:
testCall(in string a); // method #1
TestCall(in string a); // method #2
However, ColdFusion cannot differentiate between the two methods. If you call either method,
you cannot be sure which of the two will be invoked.
Passing parameters by value (in parameters)
CORBA in parameters are always passed by value. When calling a CORBA method with a
variable in ColdFusion, specify the variable name without quotation marks, as shown in the
following example:
IDL void method(in string a);
CFML <cfset foo="my string">
<cfset ret=handle.method(foo)>