码迷,mamicode.com
首页 > 数据库 > 详细

html5本地数据库(一)

时间:2015-12-15 18:07:02      阅读:1082      评论:0      收藏:0      [点我收藏+]

标签:

 

本地数据库

本地数据库

本地数据库概念

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),如下图

idnameagegenderaddress
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/

 

html5本地数据库(一)

标签:

原文地址:http://www.cnblogs.com/wenriyao/p/5048792.html

(0)
(0)
   
举报
评论 一句话评论(0
登录后才能评论!
© 2014 mamicode.com 版权所有  联系我们:gaon5@hotmail.com
迷上了代码!