cfobject: CORBA object

Description

Calls methods on a registered CORBA object.

Syntax

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

See also

cfcollection, cfexecute, cfindex, cfreport, cfsearch, cfwddx

History

New in ColdFusion MX: the Naming Service separator format for addresses has changed from a dot to a forward slash. For example, if "context=NameService", for a class, use either of the following formats for the class parameter:

(In earlier releases, the format was "Macromedia.Eng.CF".)

New in ColdFusion MX: the locale attribute specifies the Java config that contains the properties file.

Attributes

Attribute Req/Opt Default Description
type
Optional
 
Object type:
  • com
  • corba
  • java
(The other object types do not take the type attribute.)
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.
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
name
Required
 
String; name for the instantiated component. 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. 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.

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">

Comments