CFCs require little modification to work with a SWF application. The tag cffunction tag names the method and contains the CFML logic, the cfargument tag names the arguments, and the cfreturn tag returns the result to the SWF application. The name of the CFC file (*.cfc) translates to the service name in ActionScript.
Note: For CFC methods to communicate with SWF applications, 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.
Create a CFC that interacts with a SWF application
- Create a CFC and save it as flashComponent.cfc in the helloExamples directory.
Modify the code in flashComponent.cfc so that it appears as follows:
<cfcomponent name="flashComponent">
<cffunction name="helloWorld" access="remote" returnType="Struct">
<cfset tempStruct = StructNew()>
<cfset tempStruct.timeVar = DateFormat(Now ())>
<cfset tempStruct.helloMessage = "Hello World">
<cfreturn tempStruct>
</cffunction>
</cfcomponent>In this example, the helloWorld function is created. The cfreturn tag returns the result to the SWF application.
Save the file.
The helloWorld service function is now available through the flashComponentservice to ActionScript. The following ActionScript example calls this function:import mx.remoting.*;
import mx.services.Log;
import mx.rpc.*;
// Connect to the Flash component service and create service object
var CFCService:Service = new Service(
"http://localhost/flashservices/gateway",
null,
"helloExamples.flashComponent",
null,
null );
// Call the service helloWorld() method
var pc:PendingCall = CFCService.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;
}In this example, the CFCService object references the flashComponent component in the helloExamples directory. Calling the helloWorld function in this example executes the function that is defined in flashComponent. For ColdFusion components, the component filename, including the directory structure from the web root, serves as the service name. Remember to delimit the path directories with periods rather than backslashes.