User Guide

cfobject: Java or EJB object 259
cfobject: Java or EJB object
Description
Creates and manipulates a Java and Enterprise Java Bean (EJB) object.
Syntax
<cfobject
type = "Java"
action = "Create"
class = "Java class"
name = "object name">
See also
cfcollection, cfexecute, cfindex, cfreport, cfsearch, cfwddx
Attributes
Usage
To call Java CFXs or Java objects, ColdFusion uses a Java Virtual Machine(JVM) that is
embedded in the process. You can configure JVM loading, location and settings in the
ColdFusion Administrator.
Any Java class available in the class path that is specified in the ColdFusion Administrator can be
loaded and used from ColdFusion, using the
cfobject tag.
To access Java methods and fields, do the following steps:
1 Call the cfobject tag, to load the class. See the example code.
2 Use the init method with appropriate arguments, to call a constructor. For example:
<cfset ret = myObj.init(arg1, arg2)>
Calling a public method on the object without first calling the init method results in an implicit
call to the default constructor. Arguments and return values can be any Java type (simple, array,
object). ColdFusion makes the conversions if strings are passed as arguments, but not if they are
received as return values.
Overloaded methods are supported if the number of arguments is different.
Calling EJBs
To create and call EJB objects, use the cfobject tag. In the second example below, the WebLogic
JNDI is used to register and find EJBHome instances.
Attribute Req/Opt Default Description
type Optional Object type:
• com
• corba
• java
(The other object types do not take the
type attribute.)
action Required Create: Creates a Java or WebLogic Environment object.
class Required Java class.
name Required String; name for the instantiated component.