Programming ColdFusion MX, 2nd Edition

Name

cfobject

Synopsis

<cfobject>

Allows ColdFusion to connect to various objects, including COM objects, CORBA objects, Java objects and EJBs, ColdFusion Components (CFCs), and SOAP-based web services. COM objects aren’t currently supported for Unix versions of ColdFusion. The cfobject tag can be disabled in the Security Sandbox section of the ColdFusion Administrator (ColdFusion Enterprise and ColdFusion for J2EE only).

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 differs. The JavaCast( ) function may be used to cast a ColdFusion variable before it is passed to an overloaded method.

When the cfobject tag is used to call a web service, it instantiates a proxy object for the service.

Attributes

type="COM|CORBA|Java"

The type of object to create. Required when connecting to a COM, CORBA, or Java object.

name=" name "

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