Adobe 65011817 - Fireworks CS4 - Mac Extended User Manual page 292

Last updated 12/8/2009
DOM data type RPC data type
string string
URL string
void void
Security
The RPC server restricts some operations to make sure that a client cannot use the RPC server maliciously to damage
the user's system. The first security mechanism is that the RPC server binds to the loopback address, 127.0.0.1. This
means all clients must run on the same computer as the RPC server and must connect to that computer through the
loopback address. The second security mechanism prevents the exposure of "dangerous" classes that are normally on
the Fireworks JavaScript DOM, such as the JavaScript
and export and save PNG and other image files. Third, certain methods and properties that could be used maliciously
are not permitted in remote procedure calls (including all methods of the File object, see
the functions
fw.launchApp
attempts to use these methods or properties. Finally, clients can release only those objects that have been retained on
their behalf. Additionally, when a client disconnects, all the server objects that have been retained on that client's behalf
are released.
Note: Objects are not destroyed until the client releases them or until the client that created them disconnects from the
server.
RPCMethods class
To use remote procedure calls, Flash developers need to create an instance of a Fireworks object and thereafter manage
Fireworks objects carefully to save memory. In ActionScript, you should create blocks of code where you will access
the Fireworks DOM, assign a group (pool) of objects to variables, and then release those objects when you are finished.
Fireworks provides the following series of memory-management functions to support ActionScript developers
working with Fireworks objects. To learn more about using these functions, see
page 290 and "Accessing proxy
stubs file available for download from the Adobe website at www.adobe.com/go/fireworks_documentation.
Note: ActionScript remote procedure calls for Fireworks are not ActionScript 1 compatible, and must be written in
ActionScript 2.0 (using Flash MX 2004 or later).
RPCMethods.CreateAutoReleasePool()
Usage
RPCMethods.CreateAutoReleasePool()
Arguments
None.
Returns
Nothing.
Example
<string value="foo" />
<string
value="file://hd/www" />
<void />
Files
and ). The RPC server returns an invalid method error to the client if it
fw.findApp
objects" on page 290. These functions are defined in the supporting RPCMethods.as
Description
Types map identically.
A URL is a string. It usually starts with
Types map identically.
classes. However, the client can still have Fireworks open,
"Creating auto-release
EXTENDING FIREWORKS
Cross-Product Extensions
file:// .
"Files object" on page 16 and
blocks" on
288