web前端-在迷惘中的探索HTML5(二)本地存储之IndexDB

今天原本打算继续出VUE系列的教程,结果由于今天被要求从数据库请求一个压缩文件,然后放置在页面上在线浏览,我就去查相关的关于HTML5的indexDB本地数据库存储,结果网上的教程一个比一个烂我愣是看了3个小时竟然没看懂(靠,老子还学过不过忘了而已),一气之下,妈的指望别人不如靠自己。于是史上最简单的indexDB教程就要问世了

前言

吹完牛逼就该拿出真本事,众所周知,HTML5出现了本地存储系列套餐,例如localStorage,sessionStorage,还有我们的主角indexDB,对于前两个以后会仔细说,今天就好好说说indexDB。

早期各大浏览器使用WebSql,通过javascript接口异步调用Sqllite数据库,非HTML5标准,是早期标准,它有很多的缺点,如下:

  1. 在html中直接编写sql语句造成程序维护性差。
  2. 依赖于本地数据库版本。
  3. 微软、Mozilla等浏览器供应商已经声明放弃继续支持websql。

而新出来的Indexed DB:索引数据库,操作简便(目前主流浏览器正努力实现对index DB的支持),最主要的是我们可以很轻松的通过JS极其方便的对其调用,其支持现今主要的数据存储方式:JSON,这是它最大的优势。

indexDB主要对象介绍:

首先简单介绍一下indexDB都有哪些主要的对象?

  • IDBFactory:打开数据库的工厂对象,用于打开数据库,并管理数据库版本。
  • IDBOpenDBRequest:请求对象,对数据库的访问、操作都是基于请求的,通过请求对象获取其他DOM对象。
  • IDBDatabase:数据库对象,封装了对数据库表的创建、编辑等功能。
  • IDBObjectStore:类似于数据库的数据表。
  • IDBIndex:数据库索引对象,用于创建数据表的索引。
  • IDBTransaction:数据库事物控制对象。
  • IDBCursor:数据库访问游标,用于访问数据。

看到这些对象你们一定会疑问?这能干什么?有疑问才能深究才能办大事,带着你的疑问,我们踏上解答疑问之路。

IDBFactory与indexDB的获取方式

在index中我们通过

var indexDB = window.indexedDB;
console.log(indexDB); // IDBFactory对象

来获取IDBFactory对象,打开数据库的工厂对象

附上console.log的截图:

由截图我们可以得知我们通过window.indexedDB获取的其实是IDBFactory对象。所以IDBFactory对象是用来:打开数据库的工厂对象,用于创建或打开数据库,并管理数据库版本,封装在window对象的indexedDB属性中。

那它又什么方法呢?既然是工厂对象,用于创建或打开数据库,那么肯定可以打开数据库。

IDBOpenDBRequest与打开删除indexDB数据库

// open创建或打开一个数据库,返回IDBOpenDBRequest对象
var req = indexDB.open("myIndex", 3); // 第二个参数为版本,版本只能打开最新版本-可选
console.log(req);

附上console.log的截图:

由截图我们可以得知我们通过indexDB.open获取的其实是IDBOpenDBRequest对象。这是由于IDBOpenDBRequest是请求对象,而对数据库的访问、操作都是基于请求的。

既然能进行创建,当然也能删除

indexDB.deleteDatabase('myIndex');

打开了indexDB数据库,就是该访问它,及操控它,但这之前还有一点要说。

IDBOpenDBRequestindexDB数据库的调用事件

indexDB中有关于数据的调用事件,一个就是onsuccess成功时调用,一个是onerror失败时调用,一个是onupgradeneeded创建和维护数据表及更新ObjectStore,如下:

// 当数据打开失败时调用
req.onerror = function(){

}
// 当数据打开成功时调用
req.onsuccess = function(){

}
// 创建和维护数据表时调用
req.onupgradeneeded = function(){

}

这里我们常用成功的回调函数onsuccess和创建及维护数据回调函数onupgradeneeded,在这两个回调函数中IDBOpenDBRequest对象的result属性中包含本次申请的结果。

IDBOpenDBRequest对象的result属性

result属性有什么用呢?你打开了数据是为了操控数据库表,而你没有数据库对象怎么操控数据库表呢?这里result属性就是IDBDatabase数据库对象,它封装了对数据库表的创建、编辑等功能。

//当数据打开成功时调用
req.onsuccess = function(){
    //在成功后对象的result属性为本次申请的结果
    curDb = req.result; // curDb为数据库对象,用来操作数据表,维护数据表
    console.log(curDb)
}

截图说明问题:

我们可以很清楚的看到result属性就是IDBDatabase数据库对象,这样我们就可以创建数据库表(ObjectStore)、创建事物对象。

我们打开它的原型链,可以看到它的内置函数和内置对象,如图:

IDBDatabase数据库对象的内置函数:

  • close() :关闭当前数据库,释放资源。
  • createObjectStore(“storeName”,paramter):创建数据库表。
  • deleteObjectStore(“storeName”):删除当前数据库表。
  • transaction(storeNames, “type”):创建数据库事物管理对象。

IDBDatabase数据库对象的内置属性:

  • objectStoreNames:数据表名数组。
  • version :当前数据库版本。
  • name :数据库名。

这些就是一些内置方法,我们为了方便下面的使用这里就提一提。

onupgradeneeded与版本

前面我们说了onupgradeneeded是创建和维护数据表时调用,在我们使用indexDB.open时,其第二个参数就是版本号的意思,我们在不设置版本号时,第一次打开indexDB时默认会为它添加一个数字1,同时调用onupgradeneeded回调函数,在之后打开则默认使用最新的版本;我们设置版本号时,如果版本号比最新版本低则无法打开indexDB,如果比最新版本高则认为是升级维护,采用最高的版本同时也会触发调用onupgradeneeded回调函数。

// 当第一次创建数据库,或数据库升级时调用的事件
// 在创建或升级时,用来创建或修改数据表
// 只有在onupgradeneeded事件中,才能创建和维护数据表
req.onupgradeneeded = function(){
    //创建表的结构
    var db = req.result;
    console.log(db)
}

由此我们可以发现,只有在创建或升级时,在onupgradeneeded事件中创建或修改数据表。那么如何创建表呢?于是我们再次用回IDBDatabase对象的内置函数,其内置函数createObjectStore(),createObjectStore()有两个参数----第一个参数表的名字,第二个参数表的一些配置:

{
    // 两个无法联合使用
    keyPath: '', // 系统唯一标识的id 
    autoIncrement: '' // 由indexdb生成的唯一标识id,指明当前数据id自增长(indexdb),值是ID的名字
}

示例:

req.onupgradeneeded = function(){
    //创建表的结构
    var db = req.result;
    console.log(db)

    db.createObjectStore("sys_user",{
        //keyPath:,//无法与autoIncrement联合使用,自己设定的id字段的字段名
        autoIncrement:"user_id",//指明当前数据id自增长(indexdb)
    })
}

onsuccess与事物管理对象、数据库表

创建完表,我们希望在成功的回调函数里能够插入数据,所以我们得使用另外的一个对象IDBObjectStore完成数据插入功能,以及IDBTransaction对象来创建事务管理,我们先创建数据库事务管理对象,再通过事务控制对象获取数据表对象来创建数据库表,其中transaction()有两个参数第一个是数组[]里面是表名,第二个参数是读写权限:readonly(只读)、readwrite(读写),objectStore()值是表名

req.onsuccess = function(){
    //在成功后对象的result属性为本次申请的结果
    curDb = req.result; // curDb为数据库对象,用来操作数据表,维护数据表
    console.log(curDb)

    // 先创建数据库事务管理对象
    var tran = curDb.transaction(["sys_user"],"readwrite");
    console.log(tran) // IDBObjectStore
    // 再创建数据库表,通过事务控制对象获取数据表对象
    var objectStore = tran.objectStore("sys_user");
    console.log(objectStore) // IDBObjectStore
}

截图如下:

其中对象IDBObjectStore类似于数据库的数据表,其拥有一些内置方法可以实现表的增删改查。

IDBObjectStore的内置方法:

  • add(Obj):为当前数据表增加记录。参数为JSON类型,同时返回一个IDBRequest对象
  • clear():清除数据表。
  • delete(recordKey):根据指定的key值删除记录。
  • get(recordKey):根据指定的key值获取完整数据。
  • getAll():获取当前数据表中所有数据。
  • count(KeyRange):清除数据表。
  • put(obj,key):根据指定key值修改数据表数据。

使用如下:

req.onsuccess = function(){
    //在成功后对象的result属性为本次申请的结果
    curDb = req.result; // curDb为数据库对象,用来操作数据表,维护数据表
    console.log(curDb)

    // 先创建数据库事务管理对象
    var tran = curDb.transaction(["sys_user"],"readwrite");
    console.log(tran) // IDBObjectStore
    // 再创建数据库表,通过事务控制对象获取数据表对象
    var objectStore = tran.objectStore("sys_user");
    console.log(objectStore) // IDBObjectStore
    
    var user = {
        user_name: '言墨儿',
        sex: '男'
    }
    var adduser = objectStore.add(user); // 为当前数据表增加记录
    console.log(adduser) // IDBRequest
}

案例代码:

<!doctype html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Document</title>
    <script>
        // (1)Indexed DB:
        // 索引数据库,操作简便,目前主流浏览器正努力实现对index DB的支持。
        // Web SQL Database实际上已经被废弃,而HTML5的支持的本地存储实际上变成了Web Storage(Local Storage和Session Storage)与IndexedDB。Web Storage使用简单字符串键值对在本地存储数据,方便灵活,但是对于大量结构化数据存储力不从心,IndexedDB是为了能够在客户端存储大量的结构化数据,并且使用索引高效检索的API。
        // (2)indexDB主要对象介绍:
        // •    IDBFactory:打开数据库的工厂对象,用于打开数据库,并管理数据库版本。
        // •    IDBOpenDBRequest:请求对象,对数据库的访问、操作都是基于请求的,通过请求对象获取其他DOM对象。
        // •    IDBDatabase:数据库对象,封装了对数据库表的创建、编辑等功能。
        // •    IDBObjectStore:类似于数据库的数据表。
        // •    IDBIndex:数据库索引对象,用于创建数据表的索引。
        // •    IDBTransaction:数据库事物控制对象。
        // •    IDBCursor:数据库访问游标,用于访问数据。
        // (3)异步API
        // 在IndexedDB大部分操作并不是我们常用的调用方法,返回结果的模式,而是请求——响应的模式,比如打开数据库的操作
        // var request=window.indexedDB.open('testDB');
        // 这条指令并不会返回一个DB对象的句柄,我们得到的是一个IDBOpenDBRequest对象,而我们希望得到的DB对象在其result属性中,
         
        // 这条指令请求的响应是一个 IDBDatabase对象,这就是IndexedDB对象,
         
         
        // 除了result,IDBOpenDBRequest接口定义了几个重要属性
        // •    onerror: 请求失败的回调函数句柄
        // •    onsuccess:请求成功的回调函数句柄
        // •    onupgradeneeded:请求数据库版本变化句柄
         
        // 所谓异步API是指并不是这条指令执行完毕,我们就可以使用request.result来获取indexedDB对象了,就像使用ajax一样,语句执行完并不代表已经获取到了对象,所以我们一般在其回调函数中处理。

    </script>
    <script>
        var indexDB = window.indexedDB;//window.indexedDB获取IDBFactory,打开数据库的工厂对象,用于创建或打开数据库,并管理数据库版本
        console.log(indexDB);
        var curDb = null;
        window.onload = createDB();
        function createDB(){
            //open创建或打开一个数据库,返回request对象
            var req = indexDB.open("myIndex",3);//第二个参数为版本,版本只能打开最新版本
            console.log(req);
            //当数据打开失败时调用
            req.onerror = function(){

            }
            //当数据打开成功时调用
            req.onsuccess = function(){
                //在成功后对象的result属性为本次申请的结果
                curDb = req.result;//curDb为数据库对象,用来操作数据表,维护数据表
                console.log(curDb)

                //1 普通查找提供了get getAll来查询数据
                //get是根据id查询数据
                //getAll是查询全部数据
                //count方法来查找数据的数量
                //2.使用索引查找数据
                var tran = curDb.transaction(["sys_user"],"readwrite");
                console.log(tran)
                var objectStore = tran.objectStore("sys_user");
                console.log(objectStore)
                var user = {
                    user_name: '言墨儿',
                    sex: '男'
                }
                var adduser = objectStore.add(user); // 为当前数据表增加记录
                console.log(adduser)
            }
            //当第一次创建数据库,或数据库升级时调用的事件
            //在创建或升级时,用来创建或修改数据表
            //只有在onupgradeneeded事件中,才能创建和维护数据表
            req.onupgradeneeded = function(){
                //创建表的结构
                var db = req.result;
                console.log(db)
                db.createObjectStore("sys_user",{
                    //keyPath:,//无法与autoIncrement联合使用,自己设定的id字段的字段名
                    autoIncrement:"user_id",//指明当前数据id自增长(indexdb)

                })
            }
        }

        //显示数据数量
        function showCount(objectStore){
            var reque = objectStore.count();//数据库访问方法
            reque.onsuccess = function(){
                var count = event.target.result;

            }
        }
        //显示用户列表
        function showUser(objectStore){
            var request = objectStore.getAllKeys();
            request.onsuccess = function(){
                var keys = event.currentTarget.result;
                for(var i = 0;i < keys.length; i++){
                    var id = key[i];
                    var obj = objectStore;
                    var li = $("<li></li>");
                    li.html(list[i].username);
                    $("#list").append(li);
                }
            }
        }


        function delDB(){
            indexDB.deleteDatabase("myIndex");
        }
        function insertUser(){
            // ObjectStore对象可以完成数据的插入
            // 获取ObjectStore需要的DB对象
            // 用到事务对象

            //获取数据的事务控制
            var tran = curDb.transaction(["sys_user"],"readwrite");
            //通过事务控制对象获取数据表对象
            var objectStore = tran.objectStore("sys_user");
            //增加一条记录,add参数是一个JSON类型
            var user = {
                username:document.getElementById('username').value,
                password:document.getElementById('password').value,
            }
            var addRequest = objectStore.add(user); 
            addRequest.onsuccess = function(){
                alert("创建用户成功");
            }
        }
    </script>
</head>
<body>
    <input type="button" value="创建或打开" onclick="createDB()">
    <input type="button" value="删除" onclick="delDB()">
    <input type="button" value="创建用户" onclick="insertUser()">

    用户名:<input type="text" id="username">
    密码:<input type="password" id="password">
</body>
</html>

小结

到此关于indexDB的教程就结束了,希望大家多多支持我关注我,大家好好学习。

提示:后面还有精彩敬请期待,请大家关注我的专题:web前端。如有意见可以进行评论,每一条评论我都会认真对待。

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,980评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,178评论 2 380
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,868评论 0 336
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,498评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,492评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,521评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,910评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,569评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,793评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,559评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,639评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,342评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,931评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,904评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,144评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,833评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,350评论 2 342

推荐阅读更多精彩内容