html5本地数据库(一)

本地数据库

本地数据库

本地数据库概念

HTML5 的一个重要特性是本地数据持久性，结合应用程序缓存能够实现离线状态下的正常工作。此外，本地数据持久性使移动应用程序更灵敏，使用的带宽更少，而且能够在低带宽场景中更高效地工作。HTML5 提供了一些本地数据持久性选项。第一个选项是 localstorage，它支持您使用一个简单的键值对来存储数据。IndexedDB支持您本地存储大量对象，并使用健壮的数据访问机制检索数据。我们这一节就讲解indexedDB

判断浏览器是否支持

indexedDB是window中的对象，所以使用下面的代码判断

 //判断浏览器是否支持本地存储
    if (window.indexedDB) {
        alert("支持");
    } else {
        alert("不支持");
    }

新建数据库

使用open方法新建数据库，代码如下

var request = window.indexedDB.open("数据库名称", 版本号);

open方法的作用

open方法的作用是新建或者打开数据库，如果指定的数据库不存在，则创建数据库；如果已经存在，则打开数据库

open方法参数

open方法接受两个参数

• 第一个参数是数据库名称。因为一个网站可以有多个本地数据库，所以要保证这个数据库名称是唯一的
• 第二个参数是数据库版本号。每一次改变数据库的结构，比如添加、修改、删除存储对象(表)，都要变更版本号

这里我们着重说一下版本号的注意点。

• 版本号只能增，不能减。比如上次调用open方法，传入的版本号是2，再次调用的时候修改为1，则会报错
• 版本号可以为空。当版本号为空时，创建的数据库的版本号为1

实例

运行如下代码

if (window.indexedDB) {
        //注意我们没有写版本号，则默认为1
        var request= window.indexedDB.open("db1");
    } else {
        alert("不支持");
    }

下面我们来看看数据库是否创建成功，以chrome为例，按下F12或者Fn+F12，打开开发者工具，选择“Resources”选项卡

我们看到左侧的indexedDB,展开来看看

这个db1就是我们刚刚创建的数据库，右边展示的是数据库的信息,分别说明了数据库所属的域，名称以及版本号

这是如果我们再次执行上面的代码，则不会再次创建db1数据库，而是打开，因为此数据库已经存在

修改上面的代码，将版本号改为2

 if (window.indexedDB) {
        //注意我们没有写版本号，则默认为1
        var request= window.indexedDB.open("db1",2);
    } else {
        alert("不支持");
    }

再次执行这段代码，看开发者工具中indexedDB变化(注意，要刷新之后才能看到变化。刷新方法：在indexedDB上右键-“Refresh indexedDB”)

但是如果现在想再次升级数据库版本，则应将数据库的版本号修改为>2的数字，如果改为<2的数字，比如1，则不会有任何作用

获取创建的数据库

数据库创建好之后，我们需要拿到创建的数据库的引用才能够操作数据库，如创建objectstore（表）,操作数据等。

我们注意到open方法的返回值 request 了吗？但是它并是数据库的引用，open方法只是向浏览器发送了一个请求，请求新建或打开某个数据库，对象request有三个重要的事件，我们可以在这些事件中根据不同的情况编写不同的代码，首先我们熟悉一下这几个事件

• onerror：当调用open方法发生错误时，会调用这个事件,如open方法中的版本号低于数据库的版本号
• onsuccess:open方法成功执行时调用，如成功新建了数据库，或者成功打开了已有的数据库
• onupgradeneeded：此事件只有在新建数据库和数据库版本号发生变化时才被调用。注意：此事件发生在onsuccess事件之前

总结：应该将对objectstroe的操作，如创建、修改、删除操作放在onupgradeneeded事件中，而不能放在onsuccess事件中，这些操作数据数据库结构的变更，属于升级操作，而onsuccess事件每次open方法都会执行，也会调用open方法的目的只是为了添加一条数据而已。

下面我们来编写完整的代码

window.onload = function() {
        //声明变量用来存储数据库的引用
        var mydb;
    //判断浏览器是否支持本地存储
    if (window.indexedDB) {           
        //注意我们没有写版本号，则默认为1
        var request = window.indexedDB.open("db1", 2);
        request.onerror = function(e) {
            console.log("打开数据库时发生错误");
        };
        request.onsuccess = function(e) {
            mydb = e.target.result;
            console.log("打开数据库成功");
        };
        request.onupgradeneeded = function(e) {
            mydb = e.target.result;
            console.log("数据库版本变更成功");
        };
    } else {
        alert("不支持");
    }
}

console.log方法是为了在控制台中输出内容，用来调试

e.target.result获取的就是对数据库的引用，我们声明了一个全局变量mydb来存储这个引用。

这是使用indexedDB数据库一个比较完整的结构，接下来我们就创建objectStore

创建objectStore

objectStore概念

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

那么这个键是什么呢？

键为何物

在objectStore中数据的存储方式与传统的关系型数据库不一样。比如要存储下面的信息

一个人的姓名是张三，年龄是20，性别是男，籍贯是保定

传统的关系型数据库的存储方式是这这样的：首先在表中创建字段，然后再每个字段下面添加值(鉴于每张表必须要有主键的原则，我们还必须为其添加一个业务无关列，比如 id)，如下图

id	name	age	gender	address
1	张三	20	男	保定

好，这个id列就相当于objectstore中的键，目的是为了唯一标识每条数据。

但是在objectstore中数据的表示形式不是这样的，而是以键值对的形式存储数据

{name:"张三",age:20,gender:"男",address:"保定"}

我们会思考，如果还有另外一条一模一样的数据怎么办(同名同姓、想同年级、相同性别、相同籍贯的人太多了)，如果某一天我们要找张三，到底找哪个呢？

所以在objectstore中也有键的概念，我们一起来看一下在indexedDB中，应该如何指定键

在indexedDB中，键有如下类型

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

大家不要晕，今天我们只介绍一种，keyPath，剩下的大家自己就能看懂了。keyPath的意思就是使用每条记录中的某个指定字段作为键值（keyPath），比如上面的数据

{name:"张三",age:20,gender:"男",address:"保定"}

我们修改一下，新增一个id

{id:"1001",name:"张三",age:20,gender:"男",address:"保定"}

我们将id的值作为唯一标识这条数据的键，就可以使用keyPath方式，具体使用方式在创建objectstore的使用会介绍

创建objectstore

修改onupgradeneeded事件中的代码

 request.onupgradeneeded = function(e) {
            mydb = e.target.result;
            if (!mydb.objectStoreNames.contains("student")) {
                mydb.createObjectStore("student", {
                    keyPath: "id"
                });
            };
        };

mydb.objectStoreNames.contains方法用来判断数据库中是否存在名称为 student 的objectstore，如果没有则创建

createObjectStore方法用来创建objectstore，其接受两个参数，第一个参数是objectstore名称，第二个是为这个objectstore指定键的值，{keyPath: "id"}的意思是student采用keyPath类型的键，这个键的值就是数据库中id字段的值

当然，在执行这段代码之前，别忘了修改open方法中的版本号，否则这个事件是不会执行的(怎么样，被我说中了吧)

看下图(别忘了右键刷新)

也许现在你对这个“键”的概念还不是很清楚，没事，下面我们插入两条数据，一看数据你就明白了

向objectstore中插入数据

事务

在对数据进行操作之前(注意不是对数据库)，需要开始一个事务。事务中需要指定该事务跨越哪些object store。也就是说，任何对objectstore中的数据的操作都要放在事务当中

事务具有三种模式

• 只读：read，不能修改数据库数据，可以并发执行
• 读写：readwrite，可以进行读写操作
• 版本变更：verionchange

下面我们看代码如何实现

在html中加入一个按钮，点击此按钮式向名为student的objectstore插入数据

<body>
<input type="button" name="btnAdd" id="btnAdd" value="插入数据">
</body>

为此按钮添加单击事件，代码如下

document.getElementById("btnAdd").onclick = function() {
        //创建要添加的数据
        var student = {
            id:"1001",
            name: "张三",
            age: 20,
            gender: "男",
            address: "保定"
        };
        //创建针对student的事务
        var transaction = mydb.transaction(["student"], "readwrite");
        //从事务中获取要操作的objectstore
        var obj = transaction.objectStore("student");
        //添加数据
        obj.add(student);
        console.log("数据添加成功");
    }

我们拼接了一个键值对的集合，其作为要插入到student中数据，因为objectstore只接受这种格式的数据，请先记住id的值

mydb.transaction方法用来开启事务，其接受两个参数，第一个是与这个事务相关联的objectstore的名称，注意使用了[]，因为一个事务可以关联多个objectstore，第二个参数说明此事务是可读可写的，即可以在这个事务中读写数据

transaction.objectStore("student")方法在事务中获取要操作的objectstore

obj.add(student)方法用来向objectstore中插入数据

点击按钮后，刷新indexedDB，查看结果

我们看到，key的值就是键值对中id的值

添加多条数据

如果想添加多条数据，我们就需要修改一下代码

 document.getElementById("btnAdd").onclick = function() {
        //创建要添加的数据
        var student = [{
            id: "1002",
            name: "张三",
            age: 20,
            gender: "男",
            address: "保定"
        }, {
            id: "1003",
            name: "李四",
            age: 21,
            gender: "男",
            address: "国际庄"
        }, {
            id: "1004",
            name: "李丹",
            age: 22,
            gender: "女",
            address: "保定"
        }];
        //创建针对student的事务
        var transaction = mydb.transaction(["student"], "readwrite");
        //从事务中获取要操作的objectstore
        var obj = transaction.objectStore("student");
        //添加数据
        for (var i = 0; i < student.length; i++) {
            obj.add(student[i]);
        };
        console.log("数据添加成功");
    }

效果如图

思考：为什么这次id的值从1002开始，而不是1001？自己试试

查询数据

这里的查询只能根据key的值查询，不能像传统的数据库那样，可以根据任意一个键值，如name、age等查询，如果要实现这种效果的话，需要配合indexedDB中的索引和游标使用

我们首先讲解根据key值查询

添加一个按钮，用于查询数据

document.getElementById("btnQuery").onclick = function() {
        var transaction = mydb.transaction(["student"], "readwrite");
        var obj = transaction.objectStore("student");
        var request = obj.get("1002");
        request.onsuccess = function() {
            console.log("id为1002的人的姓名为" + request.result.name);
        }
    }

obj.get方法的作用是向数据库中的名称为student的objectstore请求键的值为1002对应的数据，请求的结果存储在request.result属性当中。

然后我们再onsuccess事件中获取name的值。

我们可以输出request.result的值看看

request.onsuccess = function() {
            //console.log("id为1002的人的姓名为" + request.result.name);
            console.log(request.result);
        }

结果如下

更新数据

添加一个按钮，用于更新数据，代码非常简单，直接上代码

document.getElementById("btnUpdate").onclick = function() {
        var transaction = mydb.transaction(["student"], "readwrite");
        var obj = transaction.objectStore("student");
        var request = obj.get("1002");
        request.onsuccess = function() {
            request.result.name="哈哈";
            obj.put(request.result);             
        }
    }

与查询方法很想，仍然需要在onsuccess事件中操作，首先更改request.result.name的值为新值，然后使用obj对象的put方法更新数据库

查看结果，发现值已经更改

删除数据

删除数据是最简单的

document.getElementById("btndel").onclick = function() {
        var transaction = mydb.transaction(["student"], "readwrite");
        var obj = transaction.objectStore("student");
        obj.delete("1002");           
    }

结果如图

删除数据库

数据库也是可以删除的

document.getElementById("btndeldb").onclick = function() {
        //关闭数据库连接
        mydb.close();
        indexedDB.deleteDatabase("db1");       
    }

删除之前应先调用close方法关闭当前的数据库连接，然后调用indexedDB.deleteDatabase方法根据数据库的名称删除即可

完整的案例

下面提供完整的案例，注意，第一次运行时应将数据库的版本号改为1

<!DOCTYPE html>
<html>

<head>
<title>本地数据库</title>
<script type="text/javascript">
window.onload = function() {
    //声明变量用来存储数据库的引用
    var mydb;
    //判断浏览器是否支持本地存储
    if (window.indexedDB) {
        //注意我们没有写版本号，则默认为1
        var request = window.indexedDB.open("db1", 3);
        request.onerror = function(e) {
            console.log("打开数据库时发生错误");
        };
        request.onsuccess = function(e) {
            mydb = e.target.result;
            console.log("打开数据库成功");
        };
        request.onupgradeneeded = function(e) {
            mydb = e.target.result;
            if (!mydb.objectStoreNames.contains("student")) {
                mydb.createObjectStore("student", {
                    keyPath: "id"
                });
            };
        };
    } else {
        alert("不支持");
    }
//添加数据
    document.getElementById("btnAdd").onclick = function() {
        //创建要添加的数据
        var student = [{
            id: "1002",
            name: "张三",
            age: 20,
            gender: "男",
            address: "保定"
        }, {
            id: "1003",
            name: "李四",
            age: 21,
            gender: "男",
            address: "国际庄"
        }, {
            id: "1004",
            name: "李丹",
            age: 22,
            gender: "女",
            address: "保定"
        }];
        //创建针对student的事务
        var transaction = mydb.transaction(["student"], "readwrite");
        //从事务中获取要操作的objectstore
        var obj = transaction.objectStore("student");
        //添加数据
        for (var i = 0; i < student.length; i++) {
            obj.add(student[i]);
        };
        console.log("数据添加成功");
    }
//查询数据
    document.getElementById("btnQuery").onclick = function() {
        var transaction = mydb.transaction(["student"], "readwrite");
        var obj = transaction.objectStore("student");
        var request = obj.get("1002");
        request.onsuccess = function() {
            console.log("id为1002的人的姓名为" + request.result.name);               
        }
    }

    //更新数据
    document.getElementById("btnUpdate").onclick = function() {
        var transaction = mydb.transaction(["student"], "readwrite");
        var obj = transaction.objectStore("student");
        var request = obj.get("1002");
        request.onsuccess = function() {
            request.result.name="哈哈";
            obj.put(request.result);             
        }
    }
    //删除数据
    document.getElementById("btndel").onclick = function() {
        var transaction = mydb.transaction(["student"], "readwrite");
        var obj = transaction.objectStore("student");
        obj.delete("1002");           
    }
    document.getElementById("btndeldb").onclick = function() {
        //关闭数据库连接
        mydb.close();
        indexedDB.deleteDatabase("db1");       
    }
}
</script>
</head>

<body>
<input type="button" name="btnAdd" id="btnAdd" value="插入数据">
<input type="button" name="btnQuery" id="btnQuery" value="查询数据">
<input type="button" name="btnUpdate" id="btnUpdate" value="更新数据">
<input type="button" name="btndel" id="btndel" value="删除数据">
<input type="button" name="btndeldb" id="btndeldb" value="删除数据库">
</body>

</html>

参考资料

http://www.cnblogs.com/smileberry/p/3844269.html

http://www.cnblogs.com/dolphinX/p/3415761.html

http://www.ibm.com/developerworks/cn/web/wa-indexeddb/

http://www.thinksaas.cn/group/topic/349664/