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

作者:袖梨 2022-06-25


背景
先看看各种本地存储的变革:
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();

相关文章

精彩推荐