Create a ColdFusion page that passes a structure to a SWF application

1. Create a folder in your web root, and name it helloExamples.

2. Create a ColdFusion page, and save it as helloWorld.cfm in the helloExamples directory.

3. Modify helloWorld.cfm so that the CFML code appears as follows:

   <cfset tempStruct = StructNew()> 
   <cfset tempStruct.timeVar = DateFormat(Now ())> 
   <cfset tempStruct.helloMessage = "Hello World">

   In the example, two string variables are added to a structure; one with a formatted date and one with a simple message. The structure is passed back to the SWF application using the Flash.Result variable.

   <cfset Flash.Result = tempStruct>

4. Save the file.

Remember, the directory name is the service address. The helloWorld.cfm file is a method of the helloExamples Flash Remoting service. The following ActionScript example calls the helloWorld ColdFusion page and displays the values that it returns:

import mx.remoting.*; 
import mx.services.Log; 
import mx.rpc.*;  
 
// Connect to helloExamples service and create the howdyService service object 
    var howdyService:Service = new Service( 
            "http://localhost/flashservices/gateway", 
            null, 
            "helloExamples", 
            null,  
            null ); 
// Call the service helloWorld() method 
var pc:PendingCall = howdyService.helloWorld(); 
// Tell the service what methods handle result and fault conditions 
pc.responder = new RelayResponder( this, "helloWorld_Result", "helloWorld_Fault" ); 
 
function helloWorld_Result(re:ResultEvent) 
{ 
    // Display successful result 
    messageDisplay.text = re.result.HELLOMESSAGE; 
    timeDisplay.text = re.result.TIMEVAR; 
} 
 
function helloWorld_Fault(fe:FaultEvent) 
{ 
    // Display fault returned from service 
    messageDisplay.text = fe.fault; 
}

Create a ColdFusion page that returns an 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="cfdocexamples"> 
       SELECT * 
       FROM tblParks 
   </cfquery> 
   <cfset Flash.Pagesize = pagesize> 
   <cfset Flash.Result = myQuery>

   In this example, if a single parameter is passed from the SWF application, the pagesize variable is set to the value of the Flash.Params[1] variable; otherwise, the value of the variable is the default, 10. Next, a statement queries the database. After the querying, the pagesize variable is assigned to the Flash.Pagesize variable. Finally, the query results are assigned to the Flash.Result variable, which is returned to the SWF application.

3. Save the file.

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 variable. For example, the following code calls the getData() function of the CFMService and uses the first parameter to request a page size of 5:

import mx.remoting.*; 
import mx.services.Log; 
import mx.rpc.*;  
// Connect to helloExamples service and create the CFMService service object 
    var CFMService:Service = new Service( 
            "http://localhost/flashservices/gateway", 
            null, 
            "helloExamples", 
            null,  
            null ); 
// Call the service getData() method 
var pc:PendingCall = CFMService.getData(5); 
// Tell the service what methods handle result and fault conditions 
pc.responder = new RelayResponder( this, "getData_Result", "getData_Fault" ); 
 
function getData_Result(re:ResultEvent) 
{ 
    // Display successful result 
    DataGlue.bindFormatStrings(employeeData, re.result, "#PARKNAME#, #CITY#, #STATE#"); 
} 
function getData_Fault(fe:FaultEvent) 
{ 
    // Display fault returned from service 
    trace("Error description from server: " + fe.fault.description); 
}

In this example, employeeData is a Flash list box. The result handler, getData_Result, displays the columns PARKNAME, CITY, and STATE in the employeeData list box. After the initial delivery of records, the RecordSet ActionScript class assumes the task of fetching records. In this case, the list box requests more records as the user scrolls the list box.

You can configure the client-side RecordSet object to fetch records in various ways using the RecordSet.setDeliveryMode ActionScript function.