html5中本地存储替代cookie：qext.LocalStorage例子

背景
先看看各种本地存储的变革：
Cookies：浏览器均支持，容量为4KB
UserData：仅IE支持，容量为64KB
Flash：100KB
Google Gears SQLite ：需要插件支持，容量无限制
LocalStorage：HTML5，容量为5M

现准备在项目中试图取代cookie的实现，基本分析如下：
每次和服务器端进行交互，cookie都会在请求中被携带，cookie过多，也造成带宽的浪费
cookie的容量很小，或许无法满足当今互联网的本地存储需求
在IE8+、Firefox3.0+、Opera10.5+、Chrome4.0+、Safari4.0+、iPhone2.0+、Andrioid2.0+等平台下，已经完全支持HTML5的LocalStorage
在IE7即以下版本中，可以使用UserData来代替cookie，而且同样比cookie保险
用户可能清cookie，但不见得知道去清UserData或者LocalStorage，这也增强了一道代码保险

到底用啥来取代？
UserData：仅IE可用
Flash：存储空间够了，也还挺好，可这玩意儿不是HTML原生的
Google Gears：存储空间没啥限制，就是得装额外的插件
HTML5-LocalStorage：官方建议每个站点可以本地存储5M的内容，非常大了
最后再分析一下现在咱们针对的浏览器：IE系列、FF、Chrome、Safari、Opera，外加双核的遨游、QQ浏览器、搜狗浏览器
其中，现在的FF、Chrome、Safari、Opera已经完全支持HTML5-LocalStorage
双核的那些个浏览器，要么Webkit内核，要么IE内核（大多都是IE8的内核了），所以这些也是支持HTML5-LocalStorage的
最后就剩IE7及其以下版本，对于专门的IE，就用它们自家提供的UserData了，处理很方便
总结：用UserData和HTML5-LocalStorage结合的方式，来取代cookie！

UserData的存储情况：
2011-03-23_201627.png
UserData行为通过将数据写入一个UserData存储区（UserData store）来保存数据，userData可以将数据以XML格式保存在客户端计算机上。
该数据将一直存在，除非你人为删除或者用脚本设置了该数据的失效期。
从上面的表格可以看出，就算是一个受限（Restricted）的站点，单个文档也能存64KB的数据，整个Domain也能装得下640KB的东西。

要了解更多UserData的东西，可以点击这里

关于Expires
我们都知道，采用cookie来进行本地数据缓存，可以设定一个生命周期，在IE中采用UserData进行替代，能完美的实现。
但是对于HTML5提供的LocalStorage则没有提供现成的API，来设置某本地存储的生命周期，只能采取一些极端的手段进行模拟实现。

关于数据的批量存储、提取、删除
一个好用的组件库，应该提供更加便捷的API，原生的cookie、UserData、LocalStorage都没有提供现成的接口可调用，所以，在这里，我们来包装一个，使其拥有这样的批量接口。

代码实现
1、IE中的UserData实现
原理很简单，就是创建一个HTML节点，为其增加一个行为（behavior）：#default#userData，把待存储的数据放到该节点的属性上（setAttribute），再保存到本地即可（save）。

创建html实例：
/**
 * 创建并获取这个input:hidden实例
 * @return {HTMLInputElement} input:hidden实例
 * @private
 */
function _getInstance(){
    //把UserData绑定到input:hidden上
    var _input = null;
    //是的，不要惊讶，这里每次都会创建一个input:hidden并增加到DOM树种
    //目的是避免数据被重复写入，提早造成“磁盘空间写满”的Exception
    _input = document.createElement("input");
    _input.type = "hidden";
    _input.addBehavior("#default#userData");
    document.body.appendChild(_input);
    return _input;
}
本地数据存储：
/**
 * 将数据通过UserData的方式保存到本地，文件名为：文件名为：config.key[1].xml
 * @param {String} key 待存储数据的key，和config参数中的key是一样的
 * @param {Object} config 待存储数据相关配置
 * @cofnig {String} key 待存储数据的key
 * @config {String} value 待存储数据的内容
 * @config {String|Object} [expires] 数据的过期时间，可以是数字，单位是毫秒；也可以是日期对象，表示过期时间
 * @private
 */
function __setItem(key,config){
    try {
        var input = _getInstance();
        //创建一个Storage对象
        var storageInfo = config || {};
        //设置过期时间
        if(storageInfo.expires) {
            var expires;
            //如果设置项里的expires为数字，则表示数据的能存活的毫秒数
            if ('number' == typeof storageInfo.expires) {
                expires = new Date();
                expires.setTime(expires.getTime() + storageInfo.expires);
            }
            input.expires = expires.toUTCString();
        }
                
        //存储数据
        input.setAttribute(storageInfo.key,storageInfo.value);
        //存储到本地文件，文件名为：storageInfo.key[1].xml
        input.save(storageInfo.key);
    } catch (e) {
    }
}

再看userData本地数据的读取：
/**
 * 提取本地存储的数据
 * @param {String} config 待获取的存储数据相关配置
 * @cofnig {String} key 待获取的数据的key
 * @return {String} 本地存储的数据，获取不到时返回null
 * @example
 * qext.LocalStorage.get({
 *      key : "username"
 * });
 * @private
 */
function _getItem(config){
    try {
        var input = _getInstance();
        //载入本地文件，文件名为：config.key[1].xml
        input.load(config.key);
        //取得数据
        return input.getAttribute(config.key) || null;
    } catch (e) {
        return null;          
    }
}

模拟remove操作：
/**
 * 移除某项存储数据
 * @param {Object} config 配置参数
 * @cofnig {String} key 待存储数据的key
 * @private
 */
function _removeItem(config){
    try {
        var input = _getInstance();
        //载入存储区块
        input.load(config.key);
        //移除配置项
        input.removeAttribute(config.key);
        //强制使其过期
        var expires = new Date();
        expires.setTime(expires.getTime() - 1);
        input.expires = expires.toUTCString();
        input.save(config.key);
              
        //从allkey中删除当前key         
        //下面的代码用来记录当前保存的key，便于以后clearAll
        var result = _getItem({key : _clearAllKey});
        if(result) {
            result = result.replace(new RegExp("(^|\|)" + config.key + "(\||$)",'g'),'');
            result = {
                key : _clearAllKey,
                value : result
            };
            //保存键
            __setItem(_clearAllKey,result);
        }
              
    } catch (e) {
    }
}

2、再看HTML5-LocalStorage中expires的模拟：
在进行数据存储的时候，单独多存一个字段：key + ".expires"，如果传入的expires为数字类型，单位则是毫秒（ms）
window.localStorage.setItem(storageInfo.key,storageInfo.value);
// 如果需要指定生命周期
if(config.expires) {
    var expires;
    //如果设置项里的expires为数字，则表示数据的能存活的毫秒数
    if ('number' == typeof storageInfo.expires) {
        expires = new Date();
        expires.setTime(expires.getTime() + storageInfo.expires);
    }
 
    window.localStorage.setItem(storageInfo.key + ".expires",expires);
}

在数据读取的时候，通用读取这个字段，判断时间是否超出了生命周期
result = window.localStorage.getItem(config.key);
//过期时间判断，如果过期了，则移除该项
if(result) {
    var expires = window.localStorage.getItem(config.key + ".expires");
    result = {
        value : result,
        expires : expires ? new Date(expires) : null
    };
    if(result && result.expires && result.expires < new Date()) {
        result = null;
        window.localStorage.removeItem(config.key);
    }
}

3、提取所有key
/**
 * 获取所有的本地存储数据对应的key
 *

 * var keys = qext.LocalStorage.getAllKeys();

 * 

 * @return {Array} 所有的key
 */
getAllKeys : function(){
    var result = [];
    //支持本地存储的浏览器：IE8+、Firefox3.0+、Opera10.5+、Chrome4.0+、Safari4.0+、iPhone2.0+、Andrioid2.0+
    if(_isSupportLocalStorage) {
        var key;
        for(var i = 0,len = window.localStorage.length;i < len;i++){
            key = window.localStorage.key(i);
            if(!/.+.expires$/.test(key)) {
                result.push(key);
            }
        }
    } else if(_isSupportUserData) { //IE7及以下版本，采用UserData方式
        result = _getAllKeys();
    }
         
    return result;
}

4、清除所有本地存储的数据
/**
 * 清除所有本地存储的数据
 *

 * qext.LocalStorage.clearAll();

 * 

 */
clearAll : function(){
    //支持本地存储的浏览器：IE8+、Firefox3.0+、Opera10.5+、Chrome4.0+、Safari4.0+、iPhone2.0+、Andrioid2.0+
    if(_isSupportLocalStorage) {
        window.localStorage.clear();
    } else if(_isSupportUserData) { //IE7及以下版本，采用UserData方式
        _clearAll();
    }
}

关于使用方法
1、数据存储：qext.LocalStorage.set
// 保存单个对象到本地
qext.LocalStorage.set({
   key : "username",
   value : "baiduie",
   expires : 3600 * 1000  /*单位：ms*/
});
     
// 保存多个对象
qext.LocalStorage.set([{
   key : "username",
   value : "baiduie",
   expires : 3600 * 1000  /*单位：ms*/
},{
   key : "password",
   value : "zxlie",
   expires : 3600 * 1000  /*单位：ms*/
}]);

2、数据提取：qext.LocalStorage.get
//获取某一个本地存储，返回值为：{key:"",value:"",expires:""}，未取到值时返回值为：null
 var rst = qext.LocalStorage.get({
    key : "username"
 });
    
 //获取多个本地存储，返回值为：["","",""]，未取到值时返回值为：[null,null,null]
 qext.LocalStorage.get([{
    key : "username"
 },{
    key : "password"
 },{
    key : "sex"
 }]);
3、数据删除：qext.LocalStorage.remove
//删除一个本地存储项
qext.LocalStorage.remove({
    key : "username"
});
    
//删除多个本地存储项目
qext.LocalStorage.remove([{
    key : "username"
},{
    key : "password"
},{
    key : "sex"
}]);
4、清空所有数据：qext.LocalStorage.clearAll
// 清空所有本地存储的数据
qext.LocalStorage.clearAll();
5、获取所有本地存储的key：qext.LocalStorage.getAllKes
// 获取所有本地存储的key
var keys = qext.LocalStorage.getAllKeys();