import DojoExternalInterface; class Storage{ public static var SUCCESS = "success"; public static var FAILED = "failed"; public static var PENDING = "pending"; // Wait the following number of milliseconds before flushing public static var FLUSH_DELAY_DEFAULT = 500; public var flush_delay; public var so; public var timer; private var _NAMESPACE_KEY = "allNamespaces"; public function Storage(){ flush_delay = Storage.FLUSH_DELAY_DEFAULT; DojoExternalInterface.initialize(); DojoExternalInterface.addCallback("put", this, put); DojoExternalInterface.addCallback("putMultiple", this, putMultiple); DojoExternalInterface.addCallback("get", this, get); DojoExternalInterface.addCallback("getMultiple", this, getMultiple); DojoExternalInterface.addCallback("showSettings", this, showSettings); DojoExternalInterface.addCallback("clear", this, clear); DojoExternalInterface.addCallback("getKeys", this, getKeys); DojoExternalInterface.addCallback("getNamespaces", this, getNamespaces); DojoExternalInterface.addCallback("remove", this, remove); DojoExternalInterface.addCallback("removeMultiple", this, removeMultiple); DojoExternalInterface.addCallback("flush", this, flush); DojoExternalInterface.addCallback("setFlushDelay", this, setFlushDelay); DojoExternalInterface.addCallback("getFlushDelay", this, getFlushDelay); DojoExternalInterface.loaded(); // preload the System Settings finished button movie for offline // access so it is in the cache _root.createEmptyMovieClip("_settingsBackground", 1); _root._settingsBackground.loadMovie(DojoExternalInterface.dojoPath + "storage_dialog.swf"); } // FIXME: Whoever added this Flush code did not document why it // exists. Please also put your name and a bug number so I know // who to contact. -- Brad Neuberg // Set a new value for the flush delay timer. // Possible values: // 0 : Perform the flush synchronously after each "put" request // > 0 : Wait until 'newDelay' ms have passed without any "put" request to flush // -1 : Do not automatically flush public function setFlushDelay(newDelay){ flush_delay = Number(newDelay); } public function getFlushDelay(){ return String(flush_delay); } public function flush(namespace){ if(timer){ _global.clearTimeout(timer); delete timer; } var so = SharedObject.getLocal(namespace); var flushResults = so.flush(); // return results of this command to JavaScript var statusResults; if(flushResults == true){ statusResults = Storage.SUCCESS; }else if(flushResults == "pending"){ statusResults = Storage.PENDING; }else{ statusResults = Storage.FAILED; } DojoExternalInterface.call("dojox.storage._onStatus", statusResults, null, namespace); } public function put(keyName, keyValue, namespace){ // Get the SharedObject for these values and save it so = SharedObject.getLocal(namespace); // Save the key and value so.data[keyName] = keyValue; // Save the namespace // FIXME: Tie this into the flush/no-flush stuff below; right now // we immediately write out this namespace. -- Brad Neuberg addNamespace(namespace, keyName); // Do all the flush/no-flush stuff var keyNames = new Array(); keyNames[0] = keyName; postWrite(so, keyNames, namespace); } // FIXME: Whoever added this code did not document what the // put/get multiple functionality is and why it exists. Please // also put your name and a bug number so I know who to contact. // -- Brad Neuberg public function putMultiple(metaKey, metaValue, metaLengths, namespace){ // Get the SharedObject for these values and save it so = SharedObject.getLocal(namespace); // Create array of keys and value lengths var keys = metaKey.split(","); var lengths = metaLengths.split(","); // Loop through the array and write the values for(var i=0;i 0){ timer = _global.setTimeout(flush, flush_delay, namespace); // With a flush_delay value of 0, execute the flush request synchronously }else if(flush_delay == 0){ flush(namespace); } // Otherwise just don't flush - will be probably be flushed manually } public function get(keyName, namespace){ // Get the SharedObject for these values and save it so = SharedObject.getLocal(namespace); var results = so.data[keyName]; return results; } // Returns an array with the contents of each key value on the metaKeys array public function getMultiple(metaKeys, namespace){ // get the storage object so = SharedObject.getLocal(namespace); // Create array of keys to read var keys = metaKeys.split(","); var results = new Array(); // Read from storage into results array for(var i = 0;i < keys.length;i++){ var val = so.data[keys[i]]; val = val.split("\\").join("\\\\"); val = val.split('"').join('\\"'); results.push( val); } // Make the results array into a string var metaResults = '["' + results.join('","') + '"]'; return metaResults; } public function showSettings(){ // Show the configuration options for the Flash player, opened to the // section for local storage controls (pane 1) System.showSettings(1); // there is no way we can intercept when the Close button is pressed, allowing us // to hide the Flash dialog. Instead, we need to load a movie in the // background that we can show a close button on. _root.createEmptyMovieClip("_settingsBackground", 1); _root._settingsBackground.loadMovie(DojoExternalInterface.dojoPath + "storage_dialog.swf"); } public function clear(namespace){ so = SharedObject.getLocal(namespace); so.clear(); so.flush(); // remove this namespace entry now removeNamespace(namespace); } public function getKeys(namespace) : String{ // Returns a list of the available keys in this namespace // get the storage object so = SharedObject.getLocal(namespace); // get all of the keys var results = []; for(var i in so.data){ results.push(i); } // remove our key that records our list of namespaces for(var i = 0; i < results.length; i++){ if(results[i] == _NAMESPACE_KEY){ results.splice(i, 1); break; } } // a bug in ExternalInterface transforms Arrays into // Strings, so we can't use those here! -- BradNeuberg results = results.join(","); return results; } public function getNamespaces() : String{ var allNamespaces = SharedObject.getLocal(_NAMESPACE_KEY); var results = []; for(var i in allNamespaces.data){ results.push(i); } // a bug in ExternalInterface transforms Arrays into // Strings, so we can use those here! -- BradNeuberg results = results.join(","); return results; } public function remove(keyName, namespace){ // Removes a key // get the storage object so = SharedObject.getLocal(namespace); // delete this value delete so.data[keyName]; // save the changes so.flush(); // see if we are the last entry for this namespace var availableKeys = getKeys(namespace); if(availableKeys == ""){ // we are empty removeNamespace(namespace); } } // Removes all the values for each keys on the metaKeys array public function removeMultiple(metaKeys, namespace){ // get the storage object so = SharedObject.getLocal(namespace); // Create array of keys to read var keys = metaKeys.split(","); var results = new Array(); // Delete elements for(var i=0;i