User manual KAWAI 400 DELUXE CONSOLE

[. . . ] Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA. Last updated 8/5/2010 iii Contents Chapter 1: What's New What's new in ColdFusion 9. 0 Update 1 What's new in ColdFusion 9 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5 Chapter 2: Introduction Using the Developing ColdFusion Applications guide About Adobe ColdFusion 9 documentation . 11 Chapter 3: Introducing ColdFusion About Internet applications and web application servers About ColdFusion About J2EE and the ColdFusion architecture . [. . . ] Note: If you have enabled lazy loading by specifying fetchType='LAZY' at the entity level, when you load a parent object using load***() method, the child objects are not loaded. When you specify cascadeType='ALL or REMOVE' and try to delete the parent object by passing it through session. remove(parentObj), it does not delete the child objects. To overcome this limitation, use the load***() method with ignorelazyloading='true'. Using the AIR SyncManager class to manage data The AIR application uses the SyncManager class to fetch data from the server and synchronize the local data with the ColdFusion data source. The SyncManager uses a coldfusion. air. Session object to manage the session between the client and the local SQLite database, and uses calls to the following methods in the ColdFusion sync manager CFC: · fetch to get data from the remote system · sync to synchronize the local and remote data The following text describes basic functionality that you must implement. For details on the SyncManager and Session classes, and other classes in the coldfusion. air package, see ActionScript 3. 0 Reference. Alternatively, you can see the standalone Adobe ColdFusion ActionScript Language Reference, which is accessible through the Documentation link on the Resources page of the ColdFusion Administrator. The AIR application init() function creates and configures a SyncManager instance, and fetches the initial data from ColdFusion as shown in the following code: Last updated 8/5/2010 DEVELOPING 400 DELUXE CONSOLE 9 APPLICATIONS Flex and AIR Integration in ColdFusion 633 private function init():void { syncmanager = new SyncManager(); //The ColdFusion server and port. Port without double quotes as it is //expected to be integer and IP is taken as String. syncmanager. cfPort = CFServerPort; syncmanager. cfServer = "CFServerIP"; //The CFC that implements the ColdFusion sync manager. syncmanager. syncCFC = "AIRIntegration. empManager"; //Specify a user-defined CF destination, if not specified, default destination //'ColdFusion' will be used syncmanager. destination = 'USerDefinedCFDestination' //The event listener for conflict events returned byt the CFC syncmanager. addEventListener(ConflictEvent. CONFLICT, conflictHandler); //The local database file var dbFile:File = File. userDirectory. resolvePath("EmpManager. db"); //Create a session object, which handles all interactions between the //AIR application and the SQLite database. var sessiontoken:SessionToken = syncmanager. openSession(dbFile, 999); //Add a responder for handling session connection results. This situation occurs if the SaveCache operation tries to save null data. There are two ways to handle this situation: 1 Check whether the result property of the session token returned by the function is null: if (token. result == null) { Add the responder here } else { Directly use the token. result } 2 Check that the ArrayCollection that is input to the SaveCache function is not null. The null response indicates that the fetch operation did not get a result from the server: If (ArrayCollection != null) { Call SaveCache() function Add Responder to the SaveCache Token } else { Handle the condition here. } Last updated 8/5/2010 DEVELOPING 400 DELUXE CONSOLE 9 APPLICATIONS Flex and AIR Integration in ColdFusion 635 · If you call the SaveUpdate Method and a record with the specified primary key doesn't exist, the function inserts the record. The method updates an existing record only if the primary key exists in the client database. · After you fetch data from the server, use only the SaveCache and SaveCacheUpdate methods to save the fetched data into client side database. If you use the Save function to store the fetched data, the data is marked for insert on server on commit, and the data you just got is written back to the server. If the server-side logic handles this conflict by ignoring the primary key ID from the client, and lets the server generate a new ID, then the records are inserted, resulting in multiple copies of the data with different IDs. · For AIR integration offline support, if you do not globally declare the variables for client side ActionScript classes but attempt to save the data records fetched from server using session. saveCache() or session. saveUpdateCache(), you might encounter AIR side error stackstrace with a message similar to the following: "Error: The object of type Object does not have the Entity metadata tag at coldfusion. air::EntityCache/addMetadata()[D:\p4\depot\ColdFusion\cf_main\tools\AIRIntegrat ion\OfflineSupport\src\coldfusion\air\EntityCache. as:228]" Sending data to the server The client SyncManager object tracks all the changes to the local data that happens through the session, so that the local data and server data can be synchronized. The SyncManager also tracks the old data instances when data that is already on the server is updated locally. When the AIR application calls the Session. commit method, all changes that happened on the session are passed to the CFC sync function. The sync function determines if there are any conflicts between the returned information. Otherwise, it handles the data as described in "Conflict management" on page 635. [. . . ] The CFC includes the following methods: init() or init(primary key value) load(primary key value) save() delete() · Bean/DAO style CRUD CFCs, which creates two related CFCs: · A Bean CFC, also called a Value Object, which contains the property definitions and get and set methods. · The DAO CFC, which contains the following methods: read(primary key value) create(cfc instance) update(cfc instance) delete(cfc instance) · Data Service assembler CFC, which includes a Bean (also referred to as a Value Object), a DAO CFC, and an assembler CFC. The assembler CFC is required to take advantage of the Flex Data Services feature Use the RDS CRUD wizard 1 In Flash Builder or Eclipse, go to the RDS Dataview by doing the following: a Select Window > Show View > Other. 4 Enter the project folder where you want to save the CFC in the CFC Folder text box. [. . . ]