HTML5中Localstorage的使用教程

什么是localstorage

　　前几天在老项目中发现有对cookie的操作觉得很奇怪，咨询下来是要缓存一些信息，以避免在url上面传递参数，但没有考虑过cookie会带来什么问题：

　　① cookie大小限制在4k左右，不适合存业务数据
　　② cookie每次随http事务一起发送，浪费带宽

　　我们是做移动项目的，所以这里真实适合使用的技术是localstorage，localstorage可以说是对cookie的优化，使用它可以方便在客户端存储数据，并且不会随着http传输，但也不是没有问题：

　　① localstorage大小限制在500万字符左右，各个浏览器不一致
　　② localstorage在隐私模式下不可读取
　　③ localstorage本质是在读写文件，数据多的话会比较卡（firefox会一次性将数据导入内存，想想就觉得吓人啊）
　　④ localstorage不能被爬虫爬取，不要用它完全取代url传参

　　瑕不掩瑜，以上问题皆可避免，所以我们的关注点应该放在如何使用localstorage上，并且是如何正确使用。
localstorage的使用
　　基础知识

　　localstorage存储对象分为两种：

　　① sessionstrage： session即会话的意思，在这里的session是指用户浏览某个网站时，从进入网站到关闭网站这个时间段，session对象的有效期就只有这么长。

　　② localstorage： 将数据保存在客户端硬件设备上，不管它是什么，意思就是下次打开计算机时候数据还在。

　　两者区别就是一个作为临时保存，一个长期保存。

　　这里来一段简单的代码说明其基本使用：

xml/html code复制内容到剪贴板

1. <div id="msg" style="margin: 10px 0; border: 1px solid black; padding: 10px; width: 300px;   
2.   height: 100px;">  
3. </div>  
4. <input type="text" id="text" />  
5. <select id="type">  
6.   <option value="session">sessionstorage</option>  
7.   <option value="local">localstorage</option>  
8. </select>  
9. <button onclick="save();">  
10.   保存数据</button>  
11. <button onclick="load();">  
12.   读取数据</button>  
13. <script type="text/javascript">  
14.   var msg = document.getelementbyid('msg'),   
15.             text = document.getelementbyid('text'),   
16.             type = document.getelementbyid('type');   
17.   
18.   function save() {   
19.     var str = text.value;   
20.     var t = type.value;   
21.     if (t == 'session') {   
22.       sessionstorage.setitem('msg', str);   
23.     } else {   
24.       localstorage.setitem('msg', str);   
25.     }   
26.   }   
27.   
28.   function load() {   
29.     var t = type.value;   
30.     if (t == 'session') {   
31.       msg.innerhtml = sessionstorage.getitem('msg');   
32.     } else {   
33.       msg.innerhtml = localstorage.getitem('msg');   
34.     }   
35.   }   
36. </script>  

　真实场景

　　实际工作中对localstorage的使用一般有以下需求：

　　① 缓存一般信息，如搜索页的出发城市，达到城市，非实时定位信息

　　② 缓存城市列表数据，这个数据往往比较大

　　③ 每条缓存信息需要可追踪，比如服务器通知城市数据更新，这个时候在最近一次访问的时候要自动设置过期

　　④ 每条信息具有过期日期状态，在过期外时间需要由服务器拉取数据

xml/html code复制内容到剪贴板

1. define([], function () {   
2.   
3.   var storage = _.inherit({   
4.     //默认属性   
5.     propertys: function () {   
6.   
7.       //代理对象，默认为localstorage   
8.       this.sproxy = window.localstorage;   
9.   
10.       //60 * 60 * 24 * 30 * 1000 ms ==30天   
11.       this.defaultlifetime = 2592000000;   
12.   
13.       //本地缓存用以存放所有localstorage键值与过期日期的映射   
14.       this.keycache = 'system_key_timeout_map';   
15.   
16.       //当缓存容量已满，每次删除的缓存数   
17.       this.removenum = 5;   
18.   
19.     },   
20.   
21.     assert: function () {   
22.       if (this.sproxy === null) {   
23.         throw 'not override sproxy property';   
24.       }   
25.     },   
26.   
27.     initialize: function (opts) {   
28.       this.propertys();   
29.       this.assert();   
30.     },   
31.   
32.     /*   
33.     新增localstorage   
34.     数据格式包括唯一键值，json字符串，过期日期，存入日期   
35.     sign 为格式化后的请求参数，用于同一请求不同参数时候返回新数据，比如列表为北京的城市，后切换为上海，会判断tag不同而更新缓存数据，tag相当于签名   
36.     每一键值只会缓存一条信息   
37.     */   
38.     set: function (key, value, timeout, sign) {   
39.       var _d = new date();   
40.       //存入日期   
41.       var indate = _d.gettime();   
42.   
43.       //最终保存的数据   
44.       var entity = null;   
45.   
46.       if (!timeout) {   
47.         _d.settime(_d.gettime() + this.defaultlifetime);   
48.         timeout = _d.gettime();   
49.       }   
50.   
51.       //   
52.       this.setkeycache(key, timeout);   
53.       entity = this.buildstorageobj(value, indate, timeout, sign);   
54.   
55.       try {   
56.         this.sproxy.setitem(key, json.stringify(entity));   
57.         return true;   
58.       } catch (e) {   
59.         //localstorage写满时,全清掉   
60.         if (e.name == 'quotaexceedederror') {   
61.           //            this.sproxy.clear();   
62.           //localstorage写满时，选择离过期时间最近的数据删除，这样也会有些影响，但是感觉比全清除好些，如果缓存过多，此过程比较耗时，100ms以内   
63.           if (!this.removelastcache()) throw '本次数据存储量过大';   
64.           this.set(key, value, timeout, sign);   
65.         }   
66.         console && console.log(e);   
67.       }   
68.       return false;   
69.     },   
70.   
71.     //删除过期缓存   
72.     removeoverduecache: function () {   
73.       var tmpobj = null, i, len;   
74.   
75.       var now = new date().gettime();   
76.       //取出键值对   
77.       var cachestr = this.sproxy.getitem(this.keycache);   
78.       var cachemap = [];   
79.       var newmap = [];   
80.       if (!cachestr) {   
81.         return;   
82.       }   
83.   
84.       cachemap = json.parse(cachestr);   
85.   
86.       for (i = 0, len = cachemap.length; i < len; i++) {   
87.         tmpobj = cachemap[i];   
88.         if (tmpobj.timeout < now) {   
89.           this.sproxy.removeitem(tmpobj.key);   
90.         } else {   
91.           newmap.push(tmpobj);   
92.         }   
93.       }   
94.       this.sproxy.setitem(this.keycache, json.stringify(newmap));   
95.   
96.     },   
97.   
98.     removelastcache: function () {   
99.       var i, len;   
100.       var num = this.removenum || 5;   
101.   
102.       //取出键值对   
103.       var cachestr = this.sproxy.getitem(this.keycache);   
104.       var cachemap = [];   
105.       var delmap = [];   
106.   
107.       //说明本次存储过大   
108.       if (!cachestr) return false;   
109.   
110.       cachemap.sort(function (a, b) {   
111.         return a.timeout - b.timeout;   
112.       });   
113.   
114.       //删除了哪些数据   
115.       delmap = cachemap.splice(0, num);   
116.       for (i = 0, len = delmap.length; i < len; i++) {   
117.         this.sproxy.removeitem(delmap[i].key);   
118.       }   
119.   
120.       this.sproxy.setitem(this.keycache, json.stringify(cachemap));   
121.       return true;   
122.     },   
123.   
124.     setkeycache: function (key, timeout) {   
125.       if (!key || !timeout || timeout < new date().gettime()) return;   
126.       var i, len, tmpobj;   
127.   
128.       //获取当前已经缓存的键值字符串   
129.       var oldstr = this.sproxy.getitem(this.keycache);   
130.       var oldmap = [];   
131.       //当前key是否已经存在   
132.       var flag = false;   
133.       var obj = {};   
134.       obj.key = key;   
135.       obj.timeout = timeout;   
136.   
137.       if (oldstr) {   
138.         oldmap = json.parse(oldstr);   
139.         if (!_.isarray(oldmap)) oldmap = [];   
140.       }   
141.   
142.       for (i = 0, len = oldmap.length; i < len; i++) {   
143.         tmpobj = oldmap[i];   
144.         if (tmpobj.key == key) {   
145.           oldmap[i] = obj;   
146.           flag = true;   
147.           break;   
148.         }   
149.       }   
150.       if (!flag) oldmap.push(obj);   
151.       //最后将新数组放到缓存中   
152.       this.sproxy.setitem(this.keycache, json.stringify(oldmap));   
153.   
154.     },   
155.   
156.     buildstorageobj: function (value, indate, timeout, sign) {   
157.       var obj = {   
158.         value: value,   
159.         timeout: timeout,   
160.         sign: sign,   
161.         indate: indate   
162.       };   
163.       return obj;   
164.     },   
165.   
166.     get: function (key, sign) {   
167.       var result, now = new date().gettime();   
168.       try {   
169.         result = this.sproxy.getitem(key);   
170.         if (!result) return null;   
171.         result = json.parse(result);   
172.   
173.         //数据过期   
174.         if (result.timeout < now) return null;   
175.   
176.         //需要验证签名   
177.         if (sign) {   
178.           if (sign === result.sign)   
179.             return result.value;   
180.           return null;   
181.         } else {   
182.           return result.value;   
183.         }   
184.   
185.       } catch (e) {   
186.         console && console.log(e);   
187.       }   
188.       return null;   
189.     },   
190.   
191.     //获取签名   
192.     getsign: function (key) {   
193.       var result, sign = null;   
194.       try {   
195.         result = this.sproxy.getitem(key);   
196.         if (result) {   
197.           result = json.parse(result);   
198.           sign = result && result.sign   
199.         }   
200.       } catch (e) {   
201.         console && console.log(e);   
202.       }   
203.       return sign;   
204.     },   
205.   
206.     remove: function (key) {   
207.       return this.sproxy.removeitem(key);   
208.     },   
209.   
210.     clear: function () {   
211.       this.sproxy.clear();   
212.     }   
213.   });   
214.   
215.   storage.getinstance = function () {   
216.     if (this.instance) {   
217.       return this.instance;   
218.     } else {   
219.       return this.instance = new this();   
220.     }   
221.   };   
222.   
223.   return storage;   
224.   
225. });  

这段代码包含了localstorage的基本操作，并且对以上问题做了处理，而真实的使用还要再抽象：

xml/html code复制内容到剪贴板

1. define(['abstractstorage'], function (abstractstorage) {   
2.   
3.   var store = _.inherit({   
4.     //默认属性   
5.     propertys: function () {   
6.   
7.       //每个对象一定要具有存储键，并且不能重复   
8.       this.key = null;   
9.   
10.       //默认一条数据的生命周期，s为秒，m为分，d为天   
11.       this.lifetime = '30m';   
12.   
13.       //默认返回数据   
14.       //      this.defaultdata = null;   
15.   
16.       //代理对象，localstorage对象   
17.       this.sproxy = new abstractstorage();   
18.   
19.     },   
20.   
21.     setoption: function (options) {   
22.       _.extend(this, options);   
23.     },   
24.   
25.     assert: function () {   
26.       if (this.key === null) {   
27.         throw 'not override key property';   
28.       }   
29.       if (this.sproxy === null) {   
30.         throw 'not override sproxy property';   
31.       }   
32.     },   
33.   
34.     initialize: function (opts) {   
35.       this.propertys();   
36.       this.setoption(opts);   
37.       this.assert();   
38.     },   
39.   
40.     _getlifetime: function () {   
41.       var timeout = 0;   
42.       var str = this.lifetime;   
43.       var unit = str.charat(str.length - 1);   
44.       var num = str.substring(0, str.length - 1);   
45.       var map = {   
46.         d: 86400,   
47.         h: 3600,   
48.         m: 60,   
49.         s: 1   
50.       };   
51.       if (typeof unit == 'string') {   
52.         unitunit = unit.touppercase();   
53.       }   
54.       timeout = num;   
55.       if (unit) timeout = map[unit];   
56.   
57.       //单位为毫秒   
58.       return num * timeout * 1000 ;   
59.     },   
60.   
61.     //缓存数据   
62.     set: function (value, sign) {   
63.       //获取过期时间   
64.       var timeout = new date();   
65.       timeout.settime(timeout.gettime() + this._getlifetime());   
66.       this.sproxy.set(this.key, value, timeout.gettime(), sign);   
67.     },   
68.   
69.     //设置单个属性   
70.     setattr: function (name, value, sign) {   
71.       var key, obj;   
72.       if (_.isobject(name)) {   
73.         for (key in name) {   
74.           if (name.hasownproperty(key)) this.setattr(k, name[k], value);   
75.         }   
76.         return;   
77.       }   
78.   
79.       if (!sign) sign = this.getsign();   
80.   
81.       //获取当前对象   
82.       obj = this.get(sign) || {};   
83.       if (!obj) return;   
84.       obj[name] = value;   
85.       this.set(obj, sign);   
86.   
87.     },   
88.   
89.     getsign: function () {   
90.       return this.sproxy.getsign(this.key);   
91.     },   
92.   
93.     remove: function () {   
94.       this.sproxy.remove(this.key);   
95.     },   
96.   
97.     removeattr: function (attrname) {   
98.       var obj = this.get() || {};   
99.       if (obj[attrname]) {   
100.         delete obj[attrname];   
101.       }   
102.       this.set(obj);   
103.     },   
104.   
105.     get: function (sign) {   
106.       var result = [], isempty = true, a;   
107.       var obj = this.sproxy.get(this.key, sign);   
108.       var type = typeof obj;   
109.       var o = { 'string': true, 'number': true, 'boolean': true };   
110.       if (o[type]) return obj;   
111.   
112.       if (_.isarray(obj)) {   
113.         for (var i = 0, len = obj.length; i < len; i++) {   
114.           result[i] = obj[i];   
115.         }   
116.       } else if (_.isobject(obj)) {   
117.         result = obj;   
118.       }   
119.   
120.       for (a in result) {   
121.         isempty = false;   
122.         break;   
123.       }   
124.       return !isempty ? result : null;   
125.     },   
126.   
127.     getattr: function (attrname, tag) {   
128.       var obj = this.get(tag);   
129.       var attrval = null;   
130.       if (obj) {   
131.         attrval = obj[attrname];   
132.       }   
133.       return attrval;   
134.     }   
135.   
136.   });   
137.   
138.   store.getinstance = function () {   
139.     if (this.instance) {   
140.       return this.instance;   
141.     } else {   
142.       return this.instance = new this();   
143.     }   
144.   };   
145.   
146.   return store;   
147. });  

　　我们真实使用的时候是使用store这个类操作localstorage，代码结束简单测试：

　存储完成，以后都不会走请求，于是今天的代码基本结束 ，最后在android hybrid中有一后退按钮，此按钮一旦按下会回到上一个页面，这个时候里面的localstorage可能会读取失效！一个简单不靠谱的解决方案是在webapp中加入：

xml/html code复制内容到剪贴板

1. window.onunload = function () { };//适合单页应用，不要问我为什么，我也不知道  

　结语

　　localstorage是移动开发必不可少的技术点，需要深入了解，具体业务代码后续会放到git上，有兴趣的朋友可以去了解