MACROMEDIA ColdFusion MX, Develop Manual

Page: 652 / 860

652 Chapter 30: Using Server-Side ActionScript
About server-side ActionScript
Macromedia ColdFusion MX includes a module called the Macromedia Flash Remoting service
that acts as a broker for interactions between Macromedia Flash MX and ColdFusion MX. Flash
Remoting supports a range of object types, and lets you reference an ActionScript file that lives on
a ColdFusion server. You can partition data-intensive operations on the server, while limiting the
amount of network transactions necessary to get data from the server to the client.
Flash developers can create server-side ActionScript files to access ColdFusion MX resources; they
do not have to learn CFML (ColdFusion Markup Language). This ability lets you logically
separate the Flash presentation elements of your applications from the business logic. You have
the option of creating ActionScript files that reside on the server to partition this processing away
from your client applications.
You have a very simple interface for building queries using server-side ActionScript, and an
equally simple interface for invoking these queries from your client-side ActionScript.
Client-side ActionScript requirements
On the client side, you only need a small piece of code that establishes a connection to the Flash
Remoting service and references the server-side ActionScript you want to use.
For example (note embedded comments):
// This #include is needed to connect to the Flash Remoting service
#include "NetServices.as"
// This line determines where Flash MX should look for the Flash Remoting
service.
// Ordinarily, you enter the URL to your ColdFusion server.
// Port 8500 is the Flash Remoting service default.
NetServices.setDefaultGatewayUrl("http://mycfserver:8500");
// With the Flash Remoting service URL defined, you can create a connection.
gatewayConnnection = NetServices.createGatewayConnection();
// Reference the server-side ActionScript.
// In this case, the stockquotes script file lives in the web root of the
// ColdFusion server identified previously. If it lived in a subdirectory
// of the web root called "mydir," you would reference it
// as "mydir.stockquotes".
stockService = gatewayConnnection.getService("stockquotes", this);
// This line invokes the getQuotes() method defined in the stockquotes
// server-side ActionScript.
stockService.getQuotes("macr");
// Once the record set is returned, you handle the results.
// This part is up to you.
function getQuotes_Result ( result )
{
// Do something with results
}
Note: Client-side ActionScript does not support the two new server-side ActionScript functions,
CF.query
and
CF.http
.