Programming ColdFusion

Name

CFOBJECT

Synopsis

<CFOBJECT>

Allows ColdFusion to create and use COM, CORBA, and Java objects. COM objects aren’t currently supported for Unix versions of ColdFusion. The CFOBJECT tag can be disabled in the Basic Security section of the ColdFusion Administrator.

Using the CFOBJECT tag to call a Java object loads the class, but doesn’t create an instance of the object. Constructors can be explicitly called using the init( ) method:

<CFSET MyVar=MyObject.init(argument1, argument2)>

Calling a public method within an object without first calling the init( ) method results in an implicit call to the default constructor. Arguments and return values may be of any valid Java datatype. ColdFusion handles the conversion of strings automatically when they are passed as arguments or as return values. In addition, methods may be overloaded as long as the number of arguments used differ. The JavaCast( ) function may be used to cast a ColdFusion variable before it is passed to an overloaded method.

Attributes

TYPE="COM|CORBA|Java"

The type of object to create. Required.

NAME=" name "

A name for the object to be used by your application when referencing the object’s attributes and methods. Required.

CLASS=" object_class "

For a COM object, the component program ID for the object to be invoked. For a CORBA object, if CONTEXT is IOR, CLASS specifies the name of a file that contains the stringified version of the IOR. If CONTEXT is NameService, CLASS specifies a period-delimited naming context ...