Adobe ColdFusion 8

CreateObject: CORBA object

Description

The CreateObject function can call a method on a CORBA object. The object must be defined and registered for use.

Returns

A handle to a CORBA interface.

Function syntax

CreateObject(type, context, class, locale)

See also

"Integrating COM and CORBA Objects in CFML Applications" in the ColdFusion Developer's Guide

History

See the History section of the main CreateObject function page.

Parameters

Parameter

Description
type

Type of object to create.

  • com
  • corba
  • java
  • component
  • webservice
context
  • IOR: ColdFusion uses IOR to access CORBA server
  • NameService: ColdFusion uses naming service to access server. Valid only with the InitialContext of a VisiBroker ORB.
class
  • If context = "ior": absolute path of file that contains string version of the Interoperable Object Reference (IOR). ColdFusion must be able to read file; it should be local to ColdFusion server or accessible on network
  • If context = "nameservice": forward slash-delimited naming context for naming service. For example: Allaire//Doc/empobject.
locale

The name of the Java config that holds the properties file. For more information, see Configuring and Administering ColdFusion.

Usage

In the class parameter, if "context=NameService", use a dot separator for the first part of the string. Use either of the following formats:

  • "/Eng/CF"
  • ".current/Eng.current/CF"

ColdFusion supports CORBA through the Dynamic Invocation Interface (DII). To use this function with CORBA objects, you must provide the name of the file that contains a string version of the IOR, or the object's naming context in the naming service. You must provide the object's attributes, method names and method signatures.

This function supports user-defined types (structures, arrays, and sequences).

Example

myobj = CreateObject("corba", "d:\temp\tester.ior", "ior", 
    "visibroker") //    uses IOR

myobj =     CreateObject("corba", "/Eng/CF", "nameservice", 
    "visibroker")    // uses nameservice

myobj =     CreateObject("corba", "d:\temp\tester.ior", "nameservice")
       // uses nameservice and default configuration