Adobe ColdFusion 8

cfobject: CORBA object

Description

Calls methods on a registered CORBA object.

Syntax

<cfobject
    class = "filepath or naming service"
    context = "ior|nameservice"
    name = "instance name"
    type = "corba"
    locale = "type-value arguments">

Note: You can specify this tag's attributes in an attributeCollection attribute whose value is a structure. Specify the structure name in the attributeCollection attribute and use the tag's attribute names as structure keys.

See also

cfcollection, cfexecute, cfindex, cfreport, cfsearch, cfwddx; "CORBA" in the ColdFusion Developer's Guide

History

See the History section of the main cfobject tag page.

Attributes

Attribute

Req/Opt

Default

Description

class

Required

 

  • 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.

context

Required

 

  • ior: ColdFusion uses Interoperable Object Reference (IOR) to access CORBA server.
  • nameservice: ColdFusion uses naming service to access server. This option is valid only with the InitialContext of a VisiBroker Orb.

locale

Optional

 

Sets arguments for a call to init_orb. Use this attribute only for VisiBroker ORBs. It is available on C++, Version 3.2. The value must be in the form:

locale = " -ORBagentAddr 199.99.129.33 -ORBagentPort 19000"

Each type-value pair must start with a hyphen.

name

Required

 

String; name for the instantiated component. An application uses it to reference the CORBA object's methods and attributes.

type

Required for CORBA

 

Object type. Must be corba for CORBA objects.

Usage

ColdFusion Enterprise version 4.0 and later 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; and 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">