WEB本地存储:localStorage、Web SQL Database、IndexedDB

简介: 在HTML5之前,应用程序数据只能存储在 cookie 中,并且会包含在每个服务器请求中。与 cookie 不同,浏览器本地存储限制要大得多(至少5MB),并且信息不会被传输到服务器。本文将要介绍的本地存储包括:localStorage、Web SQL Database、IndexedDB。

在HTML5之前,应用程序数据只能存储在 cookie 中,并且会包含在每个服务器请求中。与 cookie 不同,浏览器本地存储限制要大得多(至少5MB),并且信息不会被传输到服务器。本文将要介绍的本地存储包括:localStorageWeb SQL DatabaseIndexedDB

localStorage

localStorage 在一般浏览器支持的是5M大小,在不同的浏览器中 localStorage 会有所不同。

localstorage 的API有两个:localStoragesessionStorage,存在于window对象中:localStorage对应window.localStoragesessionStorage对应window.sessionStorage

localStoragesessionStorage的区别主要是在于其生存期,localStorage属于永久性存储,而sessionStorage当会话结束的时候,sessionStorage中的键值对会被清空。

localstorage为标准的键值对(Key-Value,简称KV)数据类型,简单也易扩展,只要以某种编码方式把想要存储进localstorage的对象给转化成字符串,就能轻松支持。

由于浏览器的安全策略,localstorage是无法跨域的,也无法让子域名继承父域名的localstorage数据。

在使用方面,sessionStoragelocalStorage方法是一样的。

初始化

在浏览器中使用需要判断兼容性,判断浏览器是否支持。

if(!window.localStorage){
    alert("浏览器支持localstorage");
    return false;
}

数据存储操作

数据写入的方法就是直接给window.localStorage添加一个属性,例如:window.localStorage.a 或者 window.localStorage["b"]。它的读取、写、删除操作方法很简单,是以键值对的方式存在的,如下:

const storage=window.localStorage;
//写入a字段
storage["a"]=1;
//写入b字段
storage.b=1;
//写入c字段
storage.setItem("c",3);
console.log(typeof storage["a"]);
console.log(typeof storage["b"]);
console.log(typeof storage["c"]);
storage.getItem("a");

运行后再开发工具下可以看到:

image.png

写入数据推荐使用setItem(),读取数据推荐使用getItem(),清除键值对使用removeItem()。如果希望一次性清除所有的键值对,可以使用clear()。另外,HTML5还提供了一个key()方法,可以在不知道有哪些键值的时候使用,如下:

const storage = window.localStorage;
function showStorage(){
    for(var i=0;i<storage.length;i++){
        //key(i)获得相应的键,再用getItem()方法获得对应的值
        console.log(storage.key(i)+ " : " + storage.getItem(storage.key(i)) + "<br>");
    }
}

需要注意的是,HTML5本地存储只能存字符串,任何格式存储的时候都会被自动转为字符串,所以读取的时候,需要自己进行类型的转换。

对于json数据侧存储需要调用JSON.stringify()将其转为字符串后才能存储,读取出来后调用JSON.parse()将字符串转为json格式。

storage事件

事件可以对键值对的改变进行监听,使用方法如下:

if(window.addEventListener){
    window.addEventListener("storage",handle_storage,false);
}else if(window.attachEvent){
    window.attachEvent("onstorage",handle_storage);
}
function handle_storage(e){
    if(!e){e=window.event;}
    //逻辑
}

对于事件变量e,是一个StorageEvent对象,提供了一些实用的属性,可以很好的观察键值对的变化,如下表:

Property Type Description
target EventTarget 事件目标(DOM 树中的最大目标)
type DOMString 事件的类型
bubbles Boolean 事件通常是否会出现泡沫
cancelable Boolean 事件是否可取消
key DOMString (string) 键更改时
oldValue DOMString (string) 正在更改键的旧值
newValue DOMString (string) 正在更改键的新值
url DOMString (string) 键更改的文档的地址
storageArea Storage 受影响的存储对象

Web SQL Database

Web SQL Database实际上已经被废弃

虽然Html5已经提供了功能强大的localStoragesessionStorage,但是他们两个都只能提供存储简单数据结构的数据,对于复杂的Web应用的数据却无能为力。逆天的是Html5提供了一个浏览器端的数据库支持,允许直接通JavaScript的API在浏览器端创建一个本地的数据库,而且支持标准的SQLCRUD操作,让离线的Web应用更加方便的存储结构化的数据。接下里介绍一下本地数据的相关API和用法。

  • 第一步:openDatabase方法:创建一个访问数据库的对象。
  • 第二步:使用第一步创建的数据库访问对象来执行transaction方法,通过此方法可以设置一个开启事务成功的事件响应方法,在事件响应方法中可以执行SQL.
  • 第三步:通过executeSql方法执行查询,当然查询可以是:CRUD

openDatabase方法


初次调用时创建数据库,以后就是建立连接了。

//Demo:获取或者创建一个数据库,如果数据库不存在那么创建之
const dataBase = openDatabase("student", "1.0", "学生表", 1024 * 1024, function () { });

openDatabase方法打开一个已经存在的数据库,如果数据库不存在,它还可以创建数据库。几个参数意义分别是:

  1. 数据库名称。
  2. 数据库的版本号,目前来说传个1.0就可以了,当然可以不填;
  3. 对数据库的描述。
  4. 设置分配的数据库的大小(单位是kb)。
  5. 回调函数(可省略)。

db.transaction方法可以设置一个回调函数,此函数可以接受一个参数就是我们开启的事务的对象。然后通过此对象可以进行执行Sql脚本,跟下面的步骤可以结合起来。

通过executeSql方法执行查询

ts.executeSql(sqlQuery,[value1,value2..],dataHandler,errorHandler)

参数说明:

  • qlQuery:需要具体执行的sql语句,可以是createselectupdatedelete
  • [value1,value2..]:sql语句中所有使用到的参数的数组,在executeSql方法中,将s>语句中所要使用的参数先用“?”代替,然后依次将这些参数组成数组放在第二个参数中
  • dataHandler:执行成功是调用的回调函数,通过该函数可以获得查询结果集;
  • errorHandler:执行失败时调用的回调函数;

IndexedDB

Web Storage(Local Storage和 Session Storage)与IndexedDBWeb Storage使用简单字符串键值对在本地存储数据,方便灵活,但是对于大量结构化数据存储力不从心,IndexedDB是为了能够在客户端存储大量的结构化数据,并且使用索引高效检索的API。

异步API


IndexedDB大部分操作并不是我们常用的调用方法,返回结果的模式,而是请求——响应的模式,比如打开数据库的操作

const request=window.indexedDB.open('testDB');

这条指令并不会返回一个DB对象的句柄,我们得到的是一个IDBOpenDBRequest对象,而我们希望得到的DB对象在其result属性中

image.png

这条指令请求的响应是一个 IDBDatabase 对象,这就是IndexedDB对象

image.png

除了resultIDBOpenDBRequest接口定义了几个重要属性

  • onerror: 请求失败的回调函数句柄
  • onsuccess:请求成功的回调函数句柄
  • onupgradeneeded:请求数据库版本变化句柄

所谓异步API是指并不是这条指令执行完毕,我们就可以使用request.result来获取indexedDB对象了,就像使用ajax一样,语句执行完并不代表已经获取到了对象,所以我们一般在其回调函数中处理。

创建数据库

刚才的语句已经展示了如何打开一个indexedDB数据库,调用indexedDB.open方法就可以创建或者打开一个indexedDB。看一个完整的处理

function openDB(name) {
    const request = window.indexedDB.open(name);
    request.onerror = function (e) {
        console.log("OPen Error!");
    };
    request.onsuccess = function (e) {
        myDB.db = e.target.result;
    };
}
const myDB = {
    name: "test",
    version: 1,
    db: null,
};
openDB(myDB.name);

代码中定义了一个myDB对象,在创建indexedDBrequest的成功毁掉函数中,把request获取的DB对象赋值给了myDBdb属性,这样就可以使用myDB.db来访问创建的indexedDB了。

version

我们注意到除了onerroronsuccessIDBOpenDBRequest还有一个类似回调函数句柄——onupgradeneeded。这个句柄在我们请求打开的数据库的版本号和已经存在的数据库版本号不一致的时候调用。

indexedDB.open()方法还有第二个可选参数,数据库版本号,数据库创建的时候默认版本号为1,当传入的版本号和数据库当前版本号不一致的时候onupgradeneeded就会被调用,当然不能试图打开比当前数据库版本低的version,否则调用的就是onerror了,修改一下刚才例子

function openDB (name,version) {
    const version=version || 1;
    const request=window.indexedDB.open(name,version);
    request.onerror=function(e){
        console.log(e.currentTarget.error.message);
    };
    request.onsuccess=function(e){
        myDB.db=e.target.result;
    };
    request.onupgradeneeded=function(e){
        console.log('DB version changed to '+version);
    };
} 
const myDB={
    name:'test',
    version:3,
    db:null
};
openDB(myDB.name,myDB.version);

由于刚才已经创建了版本为1的数据库,打开版本为3的时候,会在控制台输出:DB version changed to 3

关闭与删除数据库

关闭数据库可以直接调用数据库对象的close方法

function closeDB(db){
    db.close();
}

删除数据库使用indexedDB对象的deleteDatabase方法

function deleteDB(name){
    indexedDB.deleteDatabase(name);
}

简单调用

const myDB={
    name:'test',
    version:3,
    db:null
};
openDB(myDB.name,myDB.version);
setTimeout(function(){
    closeDB(myDB.db);
    deleteDB(myDB.name);
},500);

由于异步API愿意,不能保证能够在closeDB方法调用前获取db对象(实际上获取db对象也比执行一条语句慢得多),所以用了setTimeout延迟了一下。当然我们注意到每个indexedDB实例都有onclose回调函数句柄,用以数据库关闭的时候处理。

object store

有了数据库后我们自然希望创建一个表用来存储数据,但indexedDB中没有表的概念,而是objectStore,一个数据库中可以包含多个objectStoreobjectStore是一个灵活的数据结构,可以存放多种类型数据。也就是说一个objectStore相当于一张表,里面存储的每条数据和一个键相关联。

可以使用每条记录中的某个指定字段作为键值(keyPath),也可以使用自动生成的递增数字作为键值(keyGenerator),也可以不指定。选择键的类型不同,objectStore可以存储的数据结构也有差异

键类型 存储数据
不使用 任意值,但是每添加一条数据的时候需要指定键参数
keyPath Javascript对象,对象必须有一属性作为键值
keyGenerator 任意值
都使用 JavaScript对象,如果对象中有keyPath指定的属性则不生成新的键值,如果没有自动生成递增键值,填充keyPath指定属性
事务

在对新数据库做任何事情之前,需要开始一个事务。事务中需要指定该事务跨越哪些object store。

事务具有三种模式

  • 只读:read,不能修改数据库数据,可以并发执行
  • 读写:readwrite,可以进行读写操作
  • 版本变更:verionchange
const transaction=db.transaction([students','taecher']);  //打开一个事务,使用students 和teacher object store
const objectStore=transaction.objectStore('students'); //获取students object store
给object store添加数据

调用数据库实例的createObjectStore方法可以创建object store,方法有两个参数:store name和键类型。调用storeadd方法添加数据。有了上面知识,可以向object store内添加数据了

keyPath

因为对新数据的操作都需要在transaction中进行,而transaction又要求指定object store,所以只能在创建数据库的时候初始化object store以供后面使用,这正是onupgradeneeded的一个重要作用,修改一下之前代码

function openDB (name,version) {
    const version=version || 1;
    const request=window.indexedDB.open(name,version);
    request.onerror=function(e){
        console.log(e.currentTarget.error.message);
    };
    request.onsuccess=function(e){
        myDB.db=e.target.result;
    };
    request.onupgradeneeded=function(e){
        const db=e.target.result;
        if(!db.objectStoreNames.contains('students')){
            db.createObjectStore('students',{keyPath:"id"});
        }
        console.log('DB version changed to '+version);
    };
}

这样在创建数据库的时候就为其添加了一个名为studentsobject store,准备一些数据以供添加

const students=[{ 
    id:1001, 
    name:"Byron", 
    age:24 
},{ 
    id:1002, 
    name:"Frank", 
    age:30 
},{
    id:1003, 
    name:"Aaron", 
    age:26 
}];
function addData(db,storeName){
    const transaction=db.transaction(storeName,'readwrite'); 
    const store=transaction.objectStore(storeName); 
    for(var i=0;i<students.length;i++){
        store.add(students[i]);
    }
}
openDB(myDB.name,myDB.version);
setTimeout(function(){
    addData(myDB.db,'students');
},1000);

这样就在students object store里添加了三条记录,以id为键,在chrome控制台看看效果

image.png

keyGenerate
function openDB (name,version) {
    const version=version || 1;
    const request=window.indexedDB.open(name,version);
    request.onerror=function(e){
        console.log(e.currentTarget.error.message);
    };
    request.onsuccess=function(e){
        myDB.db=e.target.result;
    };
    request.onupgradeneeded=function(e){
        const db=e.target.result;
        if(!db.objectStoreNames.contains('students')){
            db.createObjectStore('students',{autoIncrement: true});
        }
        console.log('DB version changed to '+version);
    };
}

image.png

查找数据

可以调用object store的get方法通过键获取数据,以使用keyPath做键为例:

function getDataByKey(db,storeName,value){
    const transaction=db.transaction(storeName,'readwrite'); 
    const store=transaction.objectStore(storeName); 
    const request=store.get(value); 
    request.onsuccess=function(e){ 
        var student=e.target.result; 
        console.log(student.name); 
    };
}
更新数据

可以调用object storeput方法更新数据,会自动替换键值相同的记录,达到更新目的,没有相同的则添加,以使用keyPath做键为例

function updateDataByKey(db, storeName, value) {
    const transaction = db.transaction(storeName, "readwrite");
    const store = transaction.objectStore(storeName);
    const request = store.get(value);
    request.onsuccess = function (e) {
        const student = e.target.result;
        student.age = 35;
        store.put(student);
    };
}
删除数据及object store

调用object storedelete方法根据键值删除记录

function deleteDataByKey(db, storeName, value) {
    const transaction = db.transaction(storeName, "readwrite");
    const store = transaction.objectStore(storeName);
    store.delete(value);
}

调用object storeclear方法可以清空object store

function clearObjectStore(db, storeName) {
    const transaction = db.transaction(storeName, "readwrite");
    const store = transaction.objectStore(storeName);
    store.clear();
}

调用数据库实例的deleteObjectStore方法可以删除一个object store,这个就得在onupgradeneeded里面调用了

if (db.objectStoreNames.contains("students")) {
    db.deleteObjectStore("students");
}
创建索引

可以在创建object store的时候指明索引,使用object storecreateIndex创建索引,方法有三个参数:

  • 索引名称
  • 索引属性字段名
  • 索引属性值是否唯一
function openDB(name, version) {
    const version = version || 1;
    const request = window.indexedDB.open(name, version);
    request.onerror = function (e) {
        console.log(e.currentTarget.error.message);
    };
    request.onsuccess = function (e) {
        myDB.db = e.target.result;
    };
    request.onupgradeneeded = function (e) {
        const db = e.target.result;
        if (!db.objectStoreNames.contains("students")) {
            const store = db.createObjectStore("students", { keyPath: "id" });
            store.createIndex("nameIndex", "name", { unique: true });
            store.createIndex("ageIndex", "age", { unique: false });
        }
        console.log("DB version changed to " + version);
    };
}
利用索引获取数据
function getDataByIndex(db, storeName) {
    const transaction = db.transaction(storeName);
    const store = transaction.objectStore(storeName);
    const index = store.index("nameIndex");
    index.get("Byron").onsuccess = function (e) {
        const student = e.target.result;
        console.log(student.id);
    };
}

这样可以利用索引快速获取数据,name的索引是唯一的没问题,但是对于age索引只会取到第一个匹配值,要想得到所有age符合条件的值就需要使用游标了

游标

indexedDB中使用索引和游标是分不开的,对数据库熟悉的同学很好理解游标是什么东东,有了数据库object store的游标,就可以利用游标遍历object store了。

使用object store的openCursor()方法打开游标

function fetchStoreByCursor(db, storeName) {
    const transaction = db.transaction(storeName);
    const store = transaction.objectStore(storeName);
    const request = store.openCursor();
    request.onsuccess = function (e) {
        const cursor = e.target.result;
        if (cursor) {
            console.log(cursor.key);
            const currentStudent = cursor.value;
            console.log(currentStudent.name);
            cursor.continue();
        }
    };
}

curson.contine()会使游标下移,直到没有数据返回undefined

index与游标结合

要想获取age26student,可以结合游标使用索引

function getMultipleData(db, storeName) {
    const transaction = db.transaction(storeName);
    const store = transaction.objectStore(storeName);
    const index = store.index("ageIndex");
    const request = index.openCursor(IDBKeyRange.only(26));
    request.onsuccess = function (e) {
        const cursor = e.target.result;
        if (cursor) {
            const student = cursor.value;
            console.log(student.id);
            cursor.continue();
        }
    };
}

这样可是使用索引打开一个游标,参数下面会讲到,在成功的句柄内获得游标便利age为26的student,也可以通过index.openKeyCursor()方法只获取每个对象的key值。

指定游标范围

index.openCursor()/index.openKeyCursor()方法在不传递参数的时候会获取object store所有记录,像上面例子一样我们可以对搜索进行筛选。

可以使用key range 限制游标中值的范围,把它作为第一个参数传给 openCursor() 或是 openKeyCursor()

  • IDBKeyRange.only(value):只获取指定数据
  • IDBKeyRange.lowerBound(value,isOpen):获取最小是value的数据,第二个参数用来指示是否排除value值本身,也就是数学中的是否是开区间
  • IDBKeyRange.upperBound(value,isOpen):和上面类似,用于获取最大值是value的数据
  • IDBKeyRange.bound(value1,value2,isOpen1,isOpen2):不用解释了吧

获取名字首字母在B-E的student

function getMultipleData(db, storeName) {
    const transaction = db.transaction(storeName);
    const store = transaction.objectStore(storeName);
    const index = store.index("nameIndex");
    const request = index.openCursor(IDBKeyRange.bound("B", "F", false, true));
    request.onsuccess = function (e) {
        const cursor = e.target.result;
        if (cursor) {
            const student = cursor.value;
            console.log(student.name);
            cursor.continue();
        }
    };
}


相关文章
|
2月前
|
存储 移动开发 大数据
HTML5 Web IndexedDB 数据库详解
IndexedDB 是一种高效的浏览器存储方案,允许在本地存储大量结构化数据,支持索引和事务,适用于需要离线和大数据处理的应用。它由数据库、对象仓库等组成,通过键值对存储数据,确保数据一致性和完整性。本介绍展示了如何创建、读取、更新和删除数据,以及事务和错误处理的最佳实践。
|
22天前
|
存储 缓存 前端开发
Web端IM聊天消息该不该用浏览器本地存储?一文即懂!
鉴于目前浏览器技术的进步(主要是HTML5的普及),在Web网页端IM聊天应用的技术选型阶段,很多开发者都会纠结到底该不该像原生移动端IM那样将聊天记录缓存在浏览器的本地,还是像传统Web端即时通讯那样继续存储在服务端?本文将为你简洁明了地讲清楚浏览器本地存储技术(Web Storage),然后你就知道到底该怎么选择了。
26 1
|
1月前
|
SQL 安全 前端开发
Web学习_SQL注入_联合查询注入
联合查询注入是一种强大的SQL注入攻击方式,攻击者可以通过 `UNION`语句合并多个查询的结果,从而获取敏感信息。防御SQL注入需要多层次的措施,包括使用预处理语句和参数化查询、输入验证和过滤、最小权限原则、隐藏错误信息以及使用Web应用防火墙。通过这些措施,可以有效地提高Web应用程序的安全性,防止SQL注入攻击。
52 2
|
1月前
|
SQL 存储 关系型数据库
SQL `CREATE DATABASE` 语法
【11月更文挑战第10天】
63 3
|
2月前
|
存储 移动开发 数据库
HTML5 Web IndexedDB 数据库常用数据存储类型
IndexedDB 支持多种数据存储类型,满足复杂数据结构的存储需求。它包括基本数据类型(如 Number、String、Boolean、Date)、对象(简单和嵌套对象)、数组、Blob(用于二进制数据如图像和视频)、ArrayBuffer 和 Typed Arrays(处理二进制数据)、结构化克隆(支持 Map 和 Set 等复杂对象),以及 JSON 数据。尽管不直接支持非序列化数据(如函数和 DOM 节点),但可以通过转换实现存储。开发者应根据具体需求选择合适的数据类型,以优化性能和使用体验。
|
2月前
|
SQL
Web for Pentester SQL sql注入靶场
Web for Pentester SQL sql注入靶场
|
2月前
|
存储 前端开发 API
前端开发中,Web Storage的存储数据的方法localstorage和sessionStorage的使用及区别
前端开发中,Web Storage的存储数据的方法localstorage和sessionStorage的使用及区别
115 0
|
3月前
|
SQL 安全 数据库
惊!Python Web安全黑洞大曝光:SQL注入、XSS、CSRF,你中招了吗?
在数字化时代,Web应用的安全性至关重要。许多Python开发者在追求功能时,常忽视SQL注入、XSS和CSRF等安全威胁。本文将深入剖析这些风险并提供最佳实践:使用参数化查询预防SQL注入;通过HTML转义阻止XSS攻击;在表单中加入CSRF令牌增强安全性。遵循这些方法,可有效提升Web应用的安全防护水平,保护用户数据与隐私。安全需持续关注与改进,每个细节都至关重要。
142 5
|
3月前
|
SQL 安全 数据库
深度揭秘:Python Web安全攻防战,SQL注入、XSS、CSRF一网打尽!
在Web开发领域,Python虽强大灵活,却也面临着SQL注入、XSS与CSRF等安全威胁。本文将剖析这些常见攻击手段,并提供示例代码,展示如何利用参数化查询、HTML转义及CSRF令牌等技术构建坚固防线,确保Python Web应用的安全性。安全之路永无止境,唯有不断改进方能应对挑战。
82 5
|
3月前
|
关系型数据库 MySQL Java
flywa报错java.sql.SQLSyntaxErrorException: Unknown database ‘flyway‘
flywa报错java.sql.SQLSyntaxErrorException: Unknown database ‘flyway‘
41 1
下一篇
DataWorks