cfobject type = "corba"

Description

Lets you call methods in CORBA objects. These objects must be defined and registered for use.

Syntax

<cfobject type = "CORBA"
  context = "context"
  class = "file or naming service"
  name = "text"
  locale = "type-value arguments">

Attributes

Attribute

Description

context
Required. Specifies one of the following:

IOR    ColdFusion uses the Interoperable Object Reference (IOR) to access the CORBA server.

NameService    ColdFusion uses the naming service to access server. "NameService" is only valid with the InitialContext of a VisiBroker Orb.

class
Required. Specifies information, depending on the context specification:

If context is IOR    Specifies the name of a file that contains the string-formatted version of the IOR. ColdFusion must be able to read this file at all times; it should be local to ColdFusion server or on the network in an open, accessible location.

If context is NameService    Specifies a period-delimited naming context for the naming service, such as Macromedia.Department.Doc.empobject.

name
Required. Name for the object. An application uses it to reference the CORBA object's methods and attributes.

locale
Optional. Sets arguments for a call to init_orb(..). Use of this attribute is specific to VisiBroker orbs, and is currently available on C++, Version 3.2. The value should be of the form:
locale = " -ORBagentAddr 199.99.129.33 -ORBagentPort 19000"
Each type-value pair must start with a hyphen "-".

Attribute	Description
context	Required. Specifies one of the following: IOR ColdFusion uses the Interoperable Object Reference (IOR) to access the CORBA server. NameService ColdFusion uses the naming service to access server. "NameService" is only valid with the InitialContext of a VisiBroker Orb.
class	Required. Specifies information, depending on the context specification: If `context` is IOR Specifies the name of a file that contains the string-formatted version of the IOR. ColdFusion must be able to read this file at all times; it should be local to ColdFusion server or on the network in an open, accessible location. If `context` is NameService Specifies a period-delimited naming context for the naming service, such as Macromedia.Department.Doc.empobject.
name	Required. Name for the object. An application uses it to reference the CORBA object's methods and attributes.
locale	Optional. Sets arguments for a call to init_orb(..). Use of this attribute is specific to VisiBroker orbs, and is currently available on C++, Version 3.2. The value should be of the form: locale = " -ORBagentAddr 199.99.129.33 -ORBagentPort 19000" Each type-value pair must start with a hyphen "-".

Usage

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

User-defined types (for example, structures) are not supported.

Example

<cfobject type = "CORBA"
  context = "IOR"
  class = "c:\\myobject.ior"
  name = "GetName">