User Guide

32 Chapter 2: Using Flash Remoting ActionScript
Although a more complex application might be structured differently, the preceding example
shows the fundamental elements of a Flash Remoting application.
Flash Remoting ActionScript classes
The Flash Remoting ActionScript classes provide methods to configure Flash Remoting, to
interact with the remote services, and to manipulate data on the client. The following table
describes the Flash Remoting classes. For additional reference information on these classes, see
Flash Remoting ActionScript Dictionary Help.
Class Purpose
Connection Helps you create and use connections to services.
The
Connection.setCredentials() method provides login information for the
gateway server. For more information on using this method, see
“Authenticating a user to the application server” on page 40.
The class includes four methods for debugging individual connections. For
more information, see “Using connection-specific debugging methods”
on page 95.
The remaining methods in this class (
addHeaders(), call(), close(),
connect() and getService()) are lower-level utilities that are not needed in
most applications. For more information, see the Connection class in Flash
Remoting ActionScript Dictionary Help.
DataGlue Binds RecordSet objects to Flash components, such as ListBox or
ComboBox, that have labels with associated data. The
DataGlue.
bindFormatStrings()
and DataGlue.bindFormatFunction() methods specify a
RecordSet object to use to populate the UI component and tell Flash how to
populate the component’s labels and data from the RecordSet object.
For more information on using DataGlue, see “Using DataGlue methods”
on page 84.
FaultEvent Returned as an argument to the fault handling method that you specify in the
responder object. It contains the fault information that is returned when a call
to a service function results in a fault condition. For more information on using
a FaultEvent object, see “Handling service results and errors” on page 43.
Log Provides a logger that you can specify as an optional parameter to the Service
constructor. It is the application author’s responsibility to customize this tool.
NetDebug Required by the NetConnection Debugger. Manages the local connection
between the Flash application that is being debugged and the NetConnection
Debugger. Includes N
etDebug.initialize() and NetDebug.trace() methods;
the latter sends a trace event to the NetConnection Debugger with a specific
ActionScript object.
The NetConnection Debugger reports information on Flash Remoting events.
For Macromedia ColdFusion MX, these events also include server activity,
such as SQL queries. For more information on using the NetConnection
Debugger, see Chapter 5, “The NetConnection Debugger,” on page 87.