indexedDB入门

概述

IndexedDB 是一个事务型数据库系统，相似于基于 SQL 的 RDBMS。 然而不一样的是它使用固定列表，IndexedDB 是一个基于 JavaScript 的面向对象的数据库。

现有的浏览器数据储存方案，都不适合储存大量数据：Cookie 的大小不超过 4KB，且每次请求都会发送回服务器 LocalStorage 在 2.5MB 到 10MB 之间（各家浏览器不一样），并且不提供搜索功能，不能创建自定义的索引。因此，须要一种新的解决方案，这就是 IndexedDB 诞生的背景

简单来讲，IndexedDB 就是浏览器提供的本地数据库。

IndexedDB 具备如下特色

• 键值对储存
• 异步操做（避免锁死浏览器）
• 支持事务
• 同源限制（协议+域名+端口）
• 存储空间大
• 支持二进制存储（ArrayBuffer 对象和 Blob 对象，可存储文件数据）

基本概念

对比关系数据库 MySql 能够获得如下关系

• 数据库：IDBDatabase
• 表格：对象仓库（IDBObjectStore）
• 行数据：对象仓库存储的一条数据
• 索引：IDBindex，加速数据的检索（在对象仓库里面可为不一样的键建立）
• 事务：IDBTransaction
• 操做请求：IDBRequest
• IDBCursor：遍历对象存储空间和索引
• IDBKeyRange：定义键的范围数据

基本操做

兼容性注意点

// 全局变量兼容性问题

window.indexedDB =
    window.indexedDB ||
    window.mozIndexedDB ||
    window.webkitIndexedDB ||
    window.msIndexedDB;

window.IDBTransaction =
    window.IDBTransaction ||
    window.webkitIDBTransaction ||
    window.msIDBTransaction;

window.IDBKeyRange =
    window.IDBKeyRange || window.webkitIDBKeyRange || window.msIDBKeyRange;

if (!window.indexedDB) {
    window.alert(
        "Your browser doesn't support a stable version of IndexedDB. Such and such feature will not be available."
    );
}
复制代码

数据库操做

打开/新建数据库

var databaseName = "MyTestDatabase";
var databaseVersion = 1;

// 打开数据库
var request = window.indexedDB.open(databaseName, databaseVersion);

request.onsuccess = function(event) {
    console.log("open success");
};

request.onerror = function(event) {
    console.log("open fail");
};

request.onupgradeneeded = function(event) {};
复制代码

window.indexedDB.open函数打开对应的数据库，若是没有该数据库就会新建。

新建数据库或者数据库版本大于当前版本会触发onupgradeneeded事件

数据库为何会有版本？ 由于数据库的数据解构可能会发生改变的，因此通常修改数据解构的操做在onupgradeneeded里面书写

删除数据库

window.indexedDB.deleteDatabase(databaseName);
复制代码

对象仓库操做（表格操做）

建立和修改表格是修改数据库的数据解构，因此我把他们写在onupgradeneeded事件里

建立表格

request.onupgradeneeded = function(event) {
    console.log("onupgradeneeded");
    db = event.target.result;

    // 建立仓库对象（建立表格）
    // 这里我将主键设置为id
    var objectStore = db.createObjectStore(objectStoreName, {
        keyPath: "id",
        autoIncrement: true
    });
};
复制代码

删除表格

request.onupgradeneeded = function(event) {
    console.log("onupgradeneeded");
    db = event.target.result;

    // 删除仓库对象（删除表格）
    db.deleteObjectStore(objectStoreName);
};
复制代码

数据操做（行数据操做）

新增数据（增）

var databaseName = "MyTestDatabase";
var databaseVersion = 1;
var db;
var objectStoreName = "objectStore1";
var storeDatas = [
    { id: "1", name: "张三", age: 18 },
    { id: "2", name: "李四", age: 19 }
];

var request = window.indexedDB.open(databaseName, databaseVersion);

request.onsuccess = function(event) {
    console.log("open success");
    db = event.target.result;

    // 将数据保存到新建的对象仓库
    var objectStore = db
        .transaction([objectStoreName], "readwrite")
        .objectStore(objectStoreName);

    storeDatas.forEach(function(dataItem) {
        // 添加一条数据
        objectStore.add(dataItem);
    });
};
复制代码

删除数据（删）

var databaseName = "MyTestDatabase";
var databaseVersion = 1;
var db;
var objectStoreName = "objectStore1";
var storeDatas = [
    { id: "1", name: "张三", age: 18 },
    { id: "2", name: "李四", age: 19 }
];

var request = window.indexedDB.open(databaseName, databaseVersion);

request.onsuccess = function(event) {
    console.log("open success");
    db = event.target.result;

    console.log("删除数据");
    var req = db
        .transaction([objectStoreName], "readwrite")
        .objectStore(objectStoreName)
        .delete("2"); // 这里的“2”指定的是主键的键值

    req.onsuccess = function() {
        console.log("删除成功");
    };

    req.onerror = function() {
        console.log("删除失败");
    };
};
复制代码

修改数据（改）

console.log("更新数据");
var req = db
    .transaction([objectStoreName], "readwrite")
    .objectStore(objectStoreName)
    .put({
        id: "2",
        name: "王五",
        age: 17
    }); // 将整条数据给替换

req.onsuccess = function() {
    console.log("更新成功");
};

req.onerror = function() {
    console.log("更新失败");
};
复制代码

获取数据（查）

console.log("读取数据");
var req = db
    .transaction([objectStoreName], "readonly")
    .objectStore(objectStoreName)
    .get("1"); // 这里的“1”也是主键的键值

req.onsuccess = function() {
    console.log("获取成功");
    console.log(req.result);
};

req.onerror = function() {
    console.log("获取失败");
};
复制代码

经过指针对象遍历表格数据

console.log("遍历数据");
var objectStore = db
    .transaction([objectStoreName], "readonly")
    .objectStore(objectStoreName);

var count = 0;
objectStore.openCursor().onsuccess = function(event) {
    var cursor = event.target.result;
    if (cursor) {
        console.log(`第${++count}条数据为`);
        console.log(cursor.value);
        cursor.continue(); // 将指针移动下一个位置
    } else {
        console.log("没有更多数据");
    }
};
复制代码

小结

indexedDB的API仍是很是多的，这里只是简单介绍了最经常使用的几个操做（我的认为^_^）。

参考文档

• IndexedDB_API
• 浏览器数据库 IndexedDB 入门教程