MACROMEDIA COLDFUSION MX 61-DEVELOPING COLDFUSION MX, Develop Manual

Page: 646 / 860

646 Chapter 29: Using the Flash Remoting Service
To create a ColdFusion page that returns a incremental record set to Flash:
1
Create a ColdFusion page, and save it as getData.cfm in the helloExamples directory.
2
Modify getData.cfm so that the code appears as follows:
<cfparam name="pagesize" default="10">
<cfif IsDefined("Flash.Params")>
<cfset pagesize = Flash.Params[1]>
</cfif>
<cfquery name="myQuery" datasource="ExampleApps">
SELECT *
FROM tblParks
</cfquery>
<cfset Flash.Pagesize = pagesize>
<cfset Flash.Result = myQuery>
In this example, if a single parameter is passed from the Flash application, the
pagesize
variable is set to the value of the
Flash.Params[1]
variable, otherwise the default is set to
10
.
Next, a
cfquery
statement queries the database. After that, the
pagesize
variable is assigned
into the
Flash.Pagesize
variable. Finally, the query results are assigned into the
Flash.Result
variable, which is returned to Flash.
3
Save your work.
When you assign a value to the
Flash.Pagesize
variable, you are specifying that if the record set
has more than a certain number of records, the record set becomes pageable and returns the
number of records specified in the
Flash.Pagesize
. For example:
include "NetServices.as"
NetServices.setDefaultGatewayUrl("http://localhost:8500/flashservices/
gateway");
gatewayConnection = NetServices.createGatewayConnection();
CFMService = gatewayConnection.getService(
"helloExamples", this);
CFMService.getData();
After the initial delivery of records, the RecordSet ActionScript class becomes responsible for
fetching records. You can configure the client-side RecordSet object to fetch records in various
ways using the
setDeliveryMode
ActionScript function.
Using Flash with ColdFusion components
ColdFusion components require little modification to work with Flash. The
cffunction
tag
names the function and contains the CFML logic, and the
cfreturn
tag returns the result to
Flash. The name of the ColdFusion component file (*.cfc) translates to the service name in
ActionScript.
Note: For ColdFusion component methods to communicate with Flash movies, you must set the
cffunction
tag’s
access
attribute to
remote
.
The following example replicates the
helloWorld
function that was previously implemented as a
ColdFusion page. For more information, see “Using the Flash Remoting service with ColdFusion
pages” on page 643 .