什么是 indexedDB
IndexedDB 是一种使用浏览器存储大量数据的方法.它创造的数据可以被查询，并且可以离线使用. IndexedDB对于那些需要存储大量数据，或者是需要离线使用的程序是非常有效的解决方法. --- MDN
上面是MDN上对于IndexedDB的介绍.其简单而言,indexedDB就是一个基于事务操作的key-value型数前端数据库.其API大多是异步的
创建一个indexedDB数据库
const request = indexedDB.open('myDatabase', 1);
request.addEventListener('success', e => {
console.log('连接数据库成功');
});
request.addEventListener('error', e => {
console.log('连接数据库失败');
});
在上面代码中我们使用indexedDB.open()创建一个indexedDB数据库.open()方法接受可以接受两个参数.第一个是数据库名,第二个是数据库的版本号.同时返回一个IDBOpenDBRequest对象用于操作数据库.其中对于open()的第一个参数数据库名,open()会先去查找本地是否已有这个数据库,如果有则直接将这个数据库返回,如果没有,则先创建这个数据库,再返回.对于第二个参数版本号,则是一个可选参数,如果不传,默认为1.但如果传入就必须是一个整数.
在通过对indexedDB.open()方法拿到一个数据库对象IDBOpenDBRequest我们可以通过监听这个对象的success事件和error事件来执行相应的操作.
创建一个对象仓库
再有了一个数据库之后,我们获取就想要去存储数据了,但是单只有数据库还不够,我们还需要有对象仓库(object store).对象仓库(object store)是indexedDB数据库的基础,其类似于MySQL中表的概念.
要创建一个对象仓库必须在upgradeneeded事件中,而upgradeneeded事件只会在版本号更新的时候触发.这是因为indexedDB API中不允许数据库中的数据仓库在同一版本中发生变化
const request = indexedDB.open('myDatabase', 2);
request.addEventListener('upgradeneeded', e => {
const db = e.target.result;
const store = db.createObjectStore('Users', {
keyPath: 'userId',
autoIncrement: false
});
console.log('创建对象仓库成功');
});
在上述代码中我们监听upgradeneeded事件,并在这个事件触发时使用createObjectStore()方法创建了一个对象仓库.createObjectStore()方法接受两个参数,第一个是对象仓库的名字,在同一数据库中,仓库名不能重复.第二个是可选参数.用于指定数据的主键,以及是否自增主键.
创建事务
OK现在我们有了数据库和对象仓库了,我们是否就可以存储数据了了.很抱歉,还是不行.我们还差最后一样东西----事务.
什么是事务
一个数据库事务通常包含了一个序列的对数据库的读/写操作。它的存在包含有以下两个目的
上面是维基百科上对数据库事务的解释.简单来说事务就是用来保证数据库操作要么全部成功,要么全部失败的一个限制.比如,在修改多条数据时,前面几条已经成功了.,在中间的某一条是失败了.那么在这时,如果是基于事务的数据库操作,那么这时数据库就应该重置前面数据的修改,放弃后面的数据修改.直接返回错误,一条数据也不修改.
const request = indexedDB.open('myDatabase', 3);
request.addEventListener('success', e => {
const db = e.target.result;
const tx = db.transaction('Users', 'readwrite');
});
上述代码中我们使用transaction()来创建一个事务.transaction()接受两个参数,第一个是你要操作的对象仓库名称,第二个是你创建的事务模式.传入 readonly时只能对对象仓库进行读操作,无法写操作.可以传入readwrite进行读写操作.
操作数据
好了现在有了数据库,对象仓库,事务之后我们终于可以存储数据了.
-
add() : 增加数据。接收一个参数，为需要保存到对象仓库中的对象。
-
put() : 增加或修改数据。接收一个参数，为需要保存到对象仓库中的对象。
-
get() : 获取数据。接收一个参数，为需要获取数据的主键值。
-
delete() : 删除数据。接收一个参数，为需要获取数据的主键值。
add 和 put 的作用类似，区别在于 put 保存数据时，如果该数据的主键在数据库中已经有相同主键的时候，则会修改数据库中对应主键的对象，而使用 add 保存数据，如果该主键已经存在，则保存失败。
添加数据
const request = indexedDB.open('myDatabase', 3);
request.addEventListener('success', e => {
const db = e.target.result;
const tx = db.transaction('Users', 'readwrite');
const store = tx.objectStore('Users');
const reqAdd = store.add({
'userId': 1,
'userName': '李白',
'age': 24
});
reqAdd.addEventListener('success', e => {
console.log('保存成功')
})
});
获取数据
const request = indexedDB.open('myDatabase', 3);
request.addEventListener('success', e => {
const db = e.target.result;
const tx = db.transaction('Users', 'readwrite');
const store = tx.objectStore('Users');
const reqGet = store.get(1);
reqGet.addEventListener('success', e => {
console.log(this.result.userName);
})
});
删除数据
const request = indexedDB.open('myDatabase', 3);
request.addEventListener('success', e => {
const db = e.target.result;
const tx = db.transaction('Users', 'readwrite');
const store = tx.objectStore('Users');
const reqDelete = store.delete(1);
reqDelete.addEventListener('success', e => {
console.log('删除数据成功');
})
});
使用游标
在上面当中我们使用get()方法传入一个主键来获取数据,但是这样只能够获取到一条数据.如果我们想要获取多条数据了怎么办.我们可以使用游标,来获取一个区间内的数据.
要使用游标,我们需要使用对象仓库上的openCursor()方法创建币打开.openCursor()方法接受两个参数.
openCursor(range?: IDBKeyRange | number | string | Date | IDBArrayKey, direction?: IDBCursorDirection): IDBRequest;
第一个是范围,范围可以是一个IDBKeyRange对象.用以下方式创建.
var boundRange = IDBKeyRange.bound(1, 10, false, false);
var onlyRange = IDBKeyRange.only(1);
var lowerRange = IDBKeyRange.lowerBound(1, false);
var upperRange = IDBKeyRange.upperBound(10, false);
第二个参数是方向.主要有一下几种
next : 游标中的数据按主键值升序排列，主键值相等的数据都被读取
nextunique : 游标中的数据按主键值升序排列，主键值相等只读取第一条数据
prev : 游标中的数据按主键值降序排列，主键值相等的数据都被读取
prevunique : 游标中的数据按主键值降序排列，主键值相等只读取第一条数据
下面让我们来看一个完整的例子
const request = indexedDB.open('myDatabase', 4);
request.addEventListener('success', e => {
const db = e.target.result;
const tx = db.transaction('Users', 'readwrite');
const store = tx.objectStore('Users');
const range = IDBKeyRange.bound(1, 10);
const req = store.openCursor(range, 'next');
req.addEventListener('success', e => {
const cursor = this.result;
if (cursor) {
console.log(cursor.value.userName);
cursor.continue();
} else {
console.log('检索结束');
}
})
});
在上面的代码中如果检索到符合条件的数据时,我们可以:
使用cursor.value拿到数据.
使用cursor.updata()更新数据.
使用cursor.delete()删除数据.
使用cursor.continue()读取下一条数据.
索引
在上面代码中我们获取数据都是用的主键.但是,在很多情况下我们并不知道我们需要数据的主键是什么,我们知道一个大概的条件.比如说年龄大于20岁的用户.这个时候我们就需要用到索引.以便有条件的查找.
创建索引
我们使用对象仓库的createIndex()方法来创建一个索引.
createIndex(name: string, keyPath: string | string[], optionalParameters?: IDBIndexParameters): IDBIndex;
createIndex()方法接收三个参数:
-
第一个参数name是索引名,不能重复.
-
第二个参数keyPath是你要在存储对象上的那个属性上建立索引,可以是一个单个的key值,也可以是一个包含key值集合的数组.
-
第三个参数optionalParameters是一个可选的对象参数{unique, multiEntry}
-
unique: 用来指定索引值是否可以重复,为true代表不能相同,为false时代表可以相同
-
multiEntry: 当第二个参数keyPath为一个数组时.如果multiEntry是true,则会以数组中的每个元素建立一条索引.如果是false,则以整个数组为keyPath值,添加一条索引.
下面让我们来看一个完整的例子,我们建立一条用户年龄的索引.
const request = indexedDB.open('myDatabase', 5);
request.addEventListener('upgradeneeded', e => {
const db = e.target.result;
const store = db.createObjectStore('Users', {
keyPath: 'userId',
autoIncrement: false
});
const idx = store.createIndex('ageIndex', 'age', {
unique: false
})
});
这样我们就创建了一条索引.
创建索引
这在创建了一条索引之后我们就可以来使用它了.我们使用对象仓库上的index方法,通过传入一个索引名.来拿到一个索引对象.
const index = store.index('ageIndex');`
然后我们就可以使用这个索引了.比如说我们要拿到年龄在20岁以上的数据,升序排列.
const request = indexedDB.open('myDatabase', 4);
request.addEventListener('success', e => {
const db = e.target.result;
const tx = db.transaction('Users', 'readwrite');
const store = tx.objectStore('Users');
const index = store.index('ageIndex');
const req = index.openCursor(IDBKeyRange.lowerBound(20), 'next');
req.addEventListener('success', e => {
const cursor = e.target.result;
if (cursor) {
console.log(cursor.value.age);
cursor.continue();
} else {
console.log('检索结束');
}
})
});
indexedDB 的兼容性
上面是我对indexedDB一些粗浅的总结,希望对大家有所帮助.如果文中有何不当之处请予以斧正,谢谢.