MACROMEDIA ColdFusion MX, Develop Manual

Page: 763 / 860

Creating and using objects 763
Each CORBA object has an interface that is defined in the CORBA Interface Definition
Language (IDL). The CORBA IDL describes the operations that can be performed on the object,
and the parameters of those operations. Clients do not have to know anything about how the
interface is implemented to make requests.
To request a service from the server, the client application gets a handle to the object from the
ORB. It uses the handle to call the methods specified by the IDL interface definition. The ORB
passes the requests to the server, which processes the requests and returns the results to the client.
For information about CORBA, see the following OMG website, which is the main web
repository for CORBA information:
www.omg.com.
Creating and using objects
You use the
cfobject
tag or the
CreateObject
function to create a named instance of an object.
You use other ColdFusion tags, such as
cfset
and
cfoutput
, to invoke the object’s properties
and methods.
The following sections provide information about creating and using objects that applies to both
COM and CORBA objects. The examples assume a sample object named “obj”, and that the
object has a property called “Property”, and methods called “Method1”, “Method2”, and
“Method3”.
Creating objects
You create, or instantiate (create a named instance of ) an object in ColdFusion with the
cfobject
tag or
CreateObject
function. The specific attributes or parameters that you use depend on the
type of object you use, and are described in detail in “Creating and using COM objects”
on page 767 and “Creating CORBA objects” on page 777 . The following examples use a
cfobject
tag to create a COM object and a
CreateObject
function to create a CORBA object:
<cfobject type="COM" action="Create" name="obj" class="sample.MyObject">
obj = CreateObject("CORBA", "d:\temp\tester.ior", "IOR", "Visibroker")
ColdFusion releases any object created by
cfobject
or
CreateObject
, or returned by other
objects, at the end of the ColdFusion page execution.
Using properties
Use standard ColdFusion statements to access properties as follows:
•
To set a property, use a statement or
cfset
tag, such as the following:
<cfset obj.property = "somevalue">
•
To get a property, use a statement or
cfset
tag, such as the following:
<cfset value = obj.property>
As shown in this example, you do not use parentheses on the right side of the equation to get a
property value.