Adobe 38043740 - ColdFusion Standard - Mac Development Manual page 1141

DEVELOPING COLDFUSION 9 APPLICATIONS
Using Web Elements and External Objects
• To set a property:
<cfset obj.property = "somevalue">
• To get a property:
<cfset value = obj.property>
Note: ColdFusion does not require consistently capitalized property and method names. However, it is good
programming practice to use the same case in ColdFusion as you do in Java to ensure consistency.
Calling methods
Object methods usually take zero or more arguments. Some methods return values, while others might not. Use the
following techniques to call methods:
If the method has no arguments, follow the method name with empty parentheses, as in the following
1
<cfset retVal = obj.Method1()>
If the method has one or more arguments, place the arguments in parentheses, separated by commas, as in the
2
following example, which has one integer argument and one string argument:
<cfset x = 23>
<cfset retVal = obj.Method1(x, "a string literal")>
Note: When you invoke a Java method, the type of the data being used is important. For more information see
ColdFusion data type conversions" on page 1139.
Calling JavaBean get and set methods
ColdFusion can automatically invoke getPropertyName() and setPropertyName(value) methods if a Java class
conforms to the JavaBeans pattern. As a result, you can set or get the property by referencing it directly, without having
to explicitly invoke a method.
For example, if the myFishTank class is a JavaBean, the following code returns the results of calling the getTotalFish()
method on the myFish object:
<cfoutput>
There are currently #myFish.TotalFish# fish in the tank.
</cfoutput>
The following example adds one guppy to a myFish object by implicitly calling the setGuppyCount(int number)
method:
<cfset myFish.GuppyCount = myFish.GuppyCount + 1>
Note: You can use the direct reference method to get or set values in some classes that have getProperty and setProperty
methods but do not conform fully to the JavaBean pattern. However, you cannot use this technique for all classes that
have getProperty and setProperty methods. For example, you cannot directly reference any of the following standard Java
classes, or classes derived from them: Date, Boolean, Short, Integer, Long, Float, Double, Char, Byte, String, List, Array.
Calling nested objects
ColdFusion supports nested (scoped) object calls. For example, if an object method returns another object and you
invoke a property or method on that object, you can use the following syntax:
<cfset prop = myObj.X.Property>.
Similarly, you can use code such as the following CFScript line:
GetPageContext().include("hello.jsp?name=Bobby");
In this code, the ColdFusion GetPageContext function returns a Java PageContext object, and the line invokes the
method of the PageContext object.
include
Last updated 1/20/2012
1136
tag:
cfset
"Java and