User manual MACROMEDIA FLASH REMOTING MX-USING FLASH REMOTING FOR FLASH MX 2004 ACTIONSCRIPT 2.0

[. . . ] Using Flash Remoting for Flash MX 2004 ActionScript 2. 0 Trademarks Add Life to the Web, Afterburner, Aftershock, Andromedia, Allaire, Animation PowerPack, Aria, Attain, Authorware, Authorware Star, Backstage, Bright Tiger, Clustercats, ColdFusion, Contribute, Design In Motion, Director, Dream Templates, Dreamweaver, Drumbeat 2000, EDJE, EJIPT, Extreme 3D, Fireworks, Flash, Flash Lite, Flex, Fontographer, FreeHand, Generator, HomeSite, JFusion, JRun, Kawa, Know Your Site, Knowledge Objects, Knowledge Stream, Knowledge Track, LikeMinds, Lingo, Live Effects, MacRecorder Logo and Design, Macromedia, Macromedia Action!, Macromedia Breeze, Macromedia Flash, Macromedia M Logo and Design, Macromedia Spectra, Macromedia xRes Logo and Design, MacroModel, Made with Macromedia, Made with Macromedia Logo and Design, MAGIC Logo and Design, Mediamaker, Movie Critic, Open Sesame!, Roundtrip, Roundtrip HTML, Shockwave, Sitespring, SoundEdit, Titlemaker, UltraDev, Web Design 101, what the web can be, and Xtra are either registered trademarks or trademarks of Macromedia, Inc. and may be registered in the United States or in other jurisdictions including internationally. Other product names, logos, designs, titles, words, or phrases mentioned within this publication may be trademarks, service marks, or trade names of Macromedia, Inc. or other entities and may be registered in certain jurisdictions including internationally. [. . . ] To replace a specific field in a record in a RecordSet object, use the editField() method. For example, the following code replaces the contents of the third record in theRecordSet RecordSet object with the contents of the newRecord variable. It then replaces the contents of the third record's DepartmentName field: var newRecord = {DepartmentID: "BA1EA720-7D79-11D3-A9280050042189548", DepartmentName: "Complaints"}; theRecordSet. replaceItemAt(2, newRecord); theRecordSet. editField(2, "DepartmentName", "Compliments"); Using notifications with RecordSet objects You can notify any ActionScript object of changes in a RecordSet object's internal state. For example, if you associate a RecordSet object with a ListBox component, and the record set gets sorted into a different order, Flash can notify the ListBox component that the record order changed, so the ListBox component can redraw itself according to the new order. Similarly, a RecordSet object can notify its associated ListBox component when all records arrive from the server. Then, if required, the ListBox can redraw itself to update its display. Note: Flash UI components such as ListBox incorporate notifications as a standard part of their use of the RecordSet ActionScript class. The addEventListener() method is only necessary if you need to receive notifications in your own ActionScript code, for example, if you create your own UI component. 78 Chapter 4: Using Flash Remoting Data in ActionScript To set up a notification event for an ActionScript object, use the RecordSet addEventListener() method and specify the object to notify when the RecordSet object changes. You can specify any object that receives change notifications in the addEventListener() method, as in the following example: myRecordSet. addEventListener("modelChanged", contact_grid); In this example, the myRecordSet object represents a record set returned from Flash Remoting, and the addEventListener() method tells Flash Remoting to notify the contact_grid object whenever the theRecordSet object changes. The object that receives the notification must include a modelChanged callback function to handle the notification. Whenever the RecordSet object changes, the modelChanged function gets called with a message object that consists of one or more entries, as follows: · The first entry, eventName, identifies the type of event or change that was made to the record. · For some types of events, the message object also includes entries identifying the first and last record in the record set that were affected by the event. The types of events that can occur and be specified in the eventName property are addItems, allRows, fetchRows, sort, removeItem, removeItems, and updateItems. Depending on the value of eventName, the following properties might provide additional information: firstItem, lastItem, removedIDs, and removedItems. For descriptions of RecordSet events and properties, see the RecordSet class in Flash Remoting ActionScript Dictionary Help. The following example creates a modelChanged function that displays a trace message with the event type and sets it up as the callback handler for changes to the myRecordSet object: var myObj = new Object(); myObj. modelchanged = function(info) { trace("Caught modelChanged event: " + info. eventName); } myRecordSet = new RecordSet(["DepartmentID", "DepartmentName"]); myRecordSet. addEventListener("modelChanged", myObj); The following example of activity on the myRecordSet RecordSet causes the modelChanged function to display addItems as the event name: var newDept = {DepartmentID: "6504", DepartmentName: "Customer Relations"}; myRecordSet. addItemAt(15, newDept); For more information on the RecordSet. addEventListener() and RecordSet. removeEventListener() methods, see the RecordSet. addEventListener() and the RecordSetRemoveEventListener in Flash Remoting ActionScript Dictionary Help. Sorting and filtering record sets The RecordSet class has methods for sorting an existing RecordSet object or creating a new RecordSet object from an existing one by applying a selection (filter) function. About working with RecordSet objects 79 Sorting record sets To sort the records of a RecordSet object, use the sortItems and sortItemBy() methods. The sortItemBy() method performs an ascending (the default) or descending sort on the records in the RecordSet object. The sortItems() method requires a comparison function as an argument, and uses that function to sort the records. The sortItemsBy() method is implemented natively in Flash Player 7. x and is substantially faster than the sortItems() method. Sorting a RecordSet object changes the order of the records in the object, but does not otherwise change the object. Subsequent calls to the getItemAt() method return records according to the new order. After you sort a RecordSet object that was returned from an application, the object no longer reflects the order of the records on the server-side record set. [. . . ] In some cases, you might be able to include recovery code, such as code to retry a call to a busy server, in the error handler. Handling errors for a Connection object 169 The error object When Flash Remoting receives a status event, Flash passes an error object that contains information about the error to the status event handler. The error object has the following format: Key name code level description details type rootcause Contents Currently, always SERVER. PROCESSING. A stack trace that indicates the processing state at the time of the exception. A nested error object that contains additional information on the cause of the error. [. . . ]