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

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:

"Macromedia/Eng/CF"
"Macromedia.current/Eng.current/CF"

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

Attribute	Req/Opt	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">