概述
前篇：web API简介(三)：客户端储存之Web Storage API
客户端储存从某一方面来说和动态网站差不多。动态网站是用服务端来储存数据，而客户端储存是用客户端来储存数据。
IndexedDB API就是现代HTML5客户端储存的方法之二。
IndexedDB介绍
IndexedDB是专门为大量结构化数据设计的。
IndexedDB有这些特性：
(1)IndexedDB数据库储存的是键值对。
(2)IndexedDB是基于事务型数据库模型的。
(3)IndexedDB API是异步型的。
(4)IndexedDB使用很多请求(requests)和响应。
(5)IndexedDB使用DOM通知你，当结果被返回的时候。
(6)IndexedDB数据库是对象型的数据库。
(7)IndexedDB不使用SQL。
(8)IndexedDB遵循同源政策。
IndexedDB有这些限制：
(1)不支持international sorting。
(2)不支持同步操作。你必须自己写同步操作代码。
(3)不支持全文搜索的部分功能，比如SQL中的LIKE功能。
储存限制
indexedDB的Storage属性有2种：永久型和临时型。
永久型数据没有任何限制，永久储存，只有当用户删除它的时候才会被删除。
临时型数据有一个全局限制和同源限制。全局限制是指临时性数据的总量不能超过磁盘总量的50%。当超出的时候，浏览器会自动删除最久远被用到的数据，直到可以储存目前需要储存的数据。同源限制是指同源下的临时型数据总量有一个限制，这个限制是全局限制的20%，但不低于10M，且不超过2G。当超出同源限制的时候，浏览器会抛出一个错误。
IndexedDB的使用模式
和MongoDB的使用差不多，具体如下：
(1)打开一个数据库。
(2)在数据库中建立一个object store。
(3)开始一项事务，并且用请求来操作数据库。
(4)通过监听DOM事件等待事务完成。
(5)利用返回的数据(request object)做一些操作。
IndexedD的数据库操作
检验是否支持IndexedDB
if (!window.indexedDB) {
window.alert("Your browser doesn't support a stable version of IndexedDB. Such and such feature will not be available.");
}
打开IndexedDB数据库
我们发出一个打开数据库的请求。请求的result是一个IDBDatabase对象。
var request = window.indexedDB.open("MyTestDatabase", 3);
其中3是版本号。版本号不能用小数，否则会被四舍五入成整数。
更新IndexedDB数据库版本
在request发出后，onerror事件和onsuccess事件响应前，如果打开的IndexedDB数据库版本比已经存在的数据库版本低，那么就会出现onerror事件，如果如果打开的IndexedDB数据库版本比已经存在的数据库版本高，就会出现onupgradeneeded事件，在onupgradeneeded事件之后才出现success事件。
var request = indexedDB.open(dbName, 2);
//存在的数据库版本比2低的时候响应如下事件。
request.onupgradeneeded = function(event) {
//数据库在event.target的resule属性里面
var db = event.target.result;
//建立object store，并设立键值
var objectStore = db.createObjectStore("customers", { keyPath: "ssn" });
//设定object store的索引name，并设定为可以重复
objectStore.createIndex("name", "name", { unique: false });
//设定object store的索引email，并设定为不可以重复
objectStore.createIndex("email", "email", { unique: true });
};
也可以利用autoIncrement设定一个自增长的键值。
//建立object store，并设立自增长的键值，储存在key字段中
var objectStore = db.createObjectStore("customers", { autoIncrement: true });
等待IndexedDB数据库返回
request.onerror = function(event) {
alert("Why didn't you allow my web app to use IndexedDB?!");
};
request.onsuccess = function(event) {
var db;
db = event.target.result;
};
如果更新数据库版本，那么可以在onupgradeneeded事件里面进行增删改查操作，也可以在随后出现的onsuccess事件里面进行。
如果不更新数据库版本，那么不会出现onupgradeneeded事件，这时只能在onsuccess事件里面进行增删改查操作。
IndexedD的增删改查
添加数据
在进行增删改查的时候，我们都需要先给数据库增加一个事务，并且设定事务的状态：readonly，readwrite，和versionchange。
var transaction = db.transaction(["customers"], "readwrite");
transaction方法返回一个IDBTransaction对象，它具有一个方法：objectStore()，这个方法返回一个IDBObjectStore对象。
var objectStore = transaction.objectStore("customers");
customerData.forEach(function(customer) {
var request = objectStore.add(customer);
request.onsuccess = function(event) {
// event.target.result === customer.ssn;
};
});
IDBObjectStore对象的add()方法能够给自己添加数据，并且返回一个请求，这个请求的event.target.result是添加的数据。
注意：add方法只能添加与原有数据不同key的数据，否则就用put方法。
删除数据
删除数据和添加数据类似。
var request = db.transaction(["customers"], "readwrite")
.objectStore("customers")
.delete("444-44-4444");
request.onsuccess = function(event) {
// It's gone!
};
读取数据
db.transaction("customers")
.objectStore("customers")
.get("444-44-4444")
.onsuccess = function(event) {
alert("Name for SSN 444-44-4444 is " + event.target.result.name);
};
注意：transaction默认使用readonly状态。
读取并改写数据
var objectStore = db.transaction(["customers"], "readwrite").objectStore("customers");
var request = objectStore.get("444-44-4444");
request.onsuccess = function(event) {
// Get the old value that we want to update
var data = event.target.result;
data.age = 42;
var requestUpdate = objectStore.put(data);
requestUpdate.onerror = function(event) {
// Do something with the error
};
requestUpdate.onsuccess = function(event) {
// Success - the data is updated!
};
};
IndexedD的游标
基本操作
IDBObjectStore对象的openCursor()方法返回一个请求，这个请求的result就是这个游标本身。这个游标的key是原数据的键值，value是原数据。
var objectStore = db.transaction("customers").objectStore("customers");
objectStore.openCursor().onsuccess = function(event) {
var cursor = event.target.result;
if (cursor) {
alert("Name for SSN " + cursor.key + " is " + cursor.value.name);
cursor.continue();
}
else {
alert("No more entries!");
}
};
利用索引
IDBObjectStore对象的index()方法返回一个打开了index的IDBObjectStore对象(把key设置为index里面的值，把value设置为原数据)。
var index = objectStore.index("name");
index.get("Donna").onsuccess = function(event) {
alert("Donna's SSN is " + event.target.result.ssn);
};
openKeyCursor()方法
IDBObjectStore对象的openCursor()方法返回一个请求，这个请求的result就是这个游标本身。这个游标的key是原数据的键值，value是原数据的主键。
index.openKeyCursor().onsuccess = function(event) {
var cursor = event.target.result;
if (cursor) {
// cursor.key is a name, like "Bill", and cursor.value is the SSN.
// No way to directly get the rest of the stored object.
alert("Name: " + cursor.key + ", SSN: " + cursor.primaryKey);
cursor.continue();
}
};
游标的范围和方向
游标的范围是一个IDBKeyRange对象。
游标的升降序和去重：next，prev，nextunique，prevunique。
如下所示：
// Only match "Donna"
var singleKeyRange = IDBKeyRange.only("Donna");
// Match anything past "Bill", including "Bill"
var lowerBoundKeyRange = IDBKeyRange.lowerBound("Bill");
// Match anything past "Bill", but don't include "Bill"
var lowerBoundOpenKeyRange = IDBKeyRange.lowerBound("Bill", true);
// Match anything up to, but not including, "Donna"
var upperBoundOpenKeyRange = IDBKeyRange.upperBound("Donna", true);
// Match anything between "Bill" and "Donna", but not including "Donna"
var boundKeyRange = IDBKeyRange.bound("Bill", "Donna", false, true);
objectStore.openCursor(boundKeyRange, "prevunique").onsuccess = function(event) {
var cursor = event.target.result;
if (cursor) {
// Do something with the entries.
cursor.continue();
}
};
锁定数据库
为了防止多人同时改写数据库，可以使用IDBDatabase对象的onblocked属性锁定数据库。
var openReq = mozIndexedDB.open("MyTestDatabase", 2);
openReq.onblocked = function(event) {
// 如果有其它tab试图访问数据库，那么它们必须关闭否则我们不能继续。
alert("Please close all other tabs with this site open!");
};
openReq.onupgradeneeded = function(event) {
// All other databases have been closed. Set everything up.
db.createObjectStore(/* ... */);
useDatabase(db);
};
openReq.onsuccess = function(event) {
var db = event.target.result;
useDatabase(db);
return;
};
function useDatabase(db) {
db.onversionchange = function(event) {
db.close();
alert("A new version of this page is ready. Please reload!");
};
// Do stuff with the database.
}