-------------------------------------------------------------------------------
|
Dojo Storage
|
-------------------------------------------------------------------------------
|
Version X.XXX (does not have separate versioning -- versioned by release date)
|
Last Release date: January 2010
|
-------------------------------------------------------------------------------
|
Project state:
|
experimental
|
-------------------------------------------------------------------------------
|
Credits
|
Brad Neuberg
|
Alex Russell
|
|
LocalStorage, BehaviorStorage, CookieStorage:
|
Jens Arps
|
-------------------------------------------------------------------------------
|
Project description
|
|
dojox.storage provides a JavaScript abstraction for persistent storage
|
as well as pluggable implementations which typically use native browser
|
extensions (e.g. Flash player, Gears)
|
|
-------------------------------------------------------------------------------
|
Dependencies:
|
|
FlashStorageProvider requires the Flash player
|
GearsStorageProvider requires the Gears extension
|
LocalStorageProvider does not require any plugins but will run only in certain
|
browsers (see below)
|
BehaviorStorageProvider does not require any plugins but will run only in IE 5+
|
CookieStorageProvider has no requirements
|
The various Air*StorageProviders require Adobe's AIR software
|
|
The open source mtasc compiler (www.mtasc.org) is needed to build the
|
ActionScript into SWF format. The SWF object is maintained within svn, so
|
this step is only necessary if Storage.as is modified. A sample build script
|
is provided (buildFlashStorage.sh)
|
|
-------------------------------------------------------------------------------
|
Documentation
|
|
See http://dojotoolkit.org/reference-guide/dojox/storage.html for Dojo Storage docs.
|
|
See dojox/storage/demos/helloworld.html for a simple Hello World example
|
you can base your code off of.
|
|
-------------------------------------------------------------------------------
|
Installation instructions
|
|
If you want to use Dojo Storage in a web browser:
|
|
These installation instructions are to use Dojo Storage in a web browser; at
|
runtime, Dojo Storage will autodetect and use the best available storage
|
option. This includes:
|
|
* localStorage: HTML 5 Web Browsers (Firefox 3+, Safari 4+, IE 8+)
|
* Google Gears (Plugin)
|
* globalStorage (Firefox 2+)
|
* userData Behavior (IE 5+)
|
* Hidden Flash (Plugin)
|
* Cookies
|
|
To have access to Dojo Storage, require "dojox.storage":
|
|
dojo.require("dojox.storage");
|
|
|
If you want to use Dojo Storage with Adobe AIR:
|
|
[TBD! Why don't you write this and contribute!]
|
|
-------------------------------------------------------------------------------
|
Additional Notes
|
|
|
STORAGE TABLE
|
-------------
|
|
|
Browser Used StorageProvider, in order of preference
|
|
IE 6 / IE7 GearsStorageProvider
|
FlashStorageProvider
|
BehaviorStorageProvider
|
CookieStorageProvider
|
|
IE 8 LocalStorageProvider
|
GearsStorageProvider
|
FlashStorageProvider
|
BehaviorStorageProvider
|
CookieStorageProvider
|
|
Safari 3 FlashStorageProvider
|
CookieStorageProvider
|
|
Safari 4 LocalStorageProvider
|
FlashStorageProvider
|
CookieStorageProvider
|
|
Chromium 4 FlashStorageProvider
|
(Mac OS) CookieStorageProvider
|
|
Firefox 2 WhatWGStorageProvider (= globalStorage)
|
GearsStorageProvider
|
FlashStorageProvider
|
CookieStorageProvider
|
|
Firefox 3 LocalStorageProvider
|
GearsStorageProvider
|
FlashStorageProvider
|
CookieStorageProvider
|
|
Opera 10 LocalStorageProvider
|
FlashStorageProvider
|
CookieStorageProvider
|
