HTML5本地数据库(WebSQL)

╰+哭是因爲堅強的太久メ 2021-09-10 13:18 362阅读 0赞

在上一篇[《HTML5的sessionStorage和localStorage》][HTML5_sessionStorage_localStorage]中，简单介绍了如何利用localStorage实现本地存储(最大5M)和sessionStorage实现回话存储；实际上，除了sessionStorage和localStorage外，HTML5还支持通过本地数据库进行本地数据存储，HTML5采用的是"SQLite"这种文件型数据库，该数据库多集中在嵌入式设备上，熟悉IOS/Android开发的同学，应该对SQLite数据库比较熟悉。

webSql允许我们直接通JS的API在浏览器端创建一个本地的数据库，而且支持标准的SQL的CRUD操作，让离线的Web应用更加方便的存储结构化的数据。接下里介绍一下本地数据的相关API和用法。

操作本地数据库的最基本的步骤是：

*  第一步：openDatabase方法：创建一个访问数据库的对象。
 *  第二步：使用第一步创建的数据库访问对象来执行transaction方法，通过此方法可以设置一个开启事务成功的事件响应方法，在事件响应方法中可以执行SQL.
 *  第三步：通过executeSql方法执行查询，当然查询可以是：CRUD。

接下来分别介绍一下相关的方法的参数和用法。

（1）openDatabase方法：

//Demo：获取或者创建一个数据库，如果数据库不存在那么创建之
    var dataBase = openDatabase("student", "1.0", "学生表", 1024 * 1024, function () { });

openDatabase方法打开一个已经存在的数据库，如果数据库不存在，它还可以创建数据库。几个参数意义分别是：

*  1，数据库名称。
 *  2，数据库的版本号，目前来说传个1.0就可以了，当然可以不填；
 *  3，对数据库的描述。
 *  4，设置分配的数据库的大小（单位是kb）。
 *  5，回调函数(可省略)。初次调用时创建数据库，以后就是建立连接了。

（2）db.transaction方法可以设置一个回调函数，此函数可以接受一个参数就是我们开启的事务的对象。然后通过此对象可以进行执行Sql脚本，跟下面的步骤可以结合起来。

（3）通过executeSql方法执行查询。

ts.executeSql(sqlQuery,[value1,value2..],dataHandler,errorHandler)

参数说明：

*  qlQuery：需要具体执行的sql语句，可以是create、select、update、delete；
 *  value1,value2..\]：sql语句中所有使用到的参数的数组，在executeSql方法中，将s>语句中所要使用的参数先用“?”代替，然后依次将这些参数组成数组放在第二个参数中
 *  ataHandler：执行成功是调用的回调函数，通过该函数可以获得查询结果集；
 *  4,errorHandler：执行失败时调用的回调函数；

可以通过浏览器查看WebSQL中存储的数据内容：

![Center][]

下面是一个综合的例子，可以看一下：

<!DOCTYPE html>
    <head>
     <script src="http://172.30.204.23:8080/iis/js/jquery/jquery.js" type="text/javascript"></script>
        <script type="text/javascript">
            function initDatabase() {
                var db = getCurrentDb();//初始化数据库
                if(!db) {
    				alert("您的浏览器不支持HTML5本地数据库");return;			
    			}
                db.transaction(function (trans) {//启动一个事务，并设置回调函数
                    //执行创建表的Sql脚本
                    trans.executeSql("create table if not exists Demo(uName text null,title text null,words text null)", [], 
    					function (trans, result) {
    					}, 
    					function (trans, message) {//消息的回调函数
    						alert(message);
    					});
    			});
    		}
    		
    		
            $(function(){
    		alert(111);
                initDatabase();
                $("#btnSave").click(function () {
                    var txtName = $("#txtName").val();
                    var txtTitle = $("#txtTitle").val();
                    var txtWords = $("#txtWords").val();
                    var db = getCurrentDb();
                    //执行sql脚本，插入数据
                    db.transaction(function (trans) {
                        trans.executeSql("insert into Demo(uName,title,words) values(?,?,?) ", [txtName, txtTitle, txtWords], function (ts, data) {
                        }, function (ts, message) {
                            alert(message);
                        });
                    });
                    showAllTheData();
                });
            });
            function getCurrentDb() {
                //打开数据库，或者直接连接数据库参数：数据库名称，版本，概述，大小
                //如果数据库不存在那么创建之
                var db = openDatabase("myDb", "1.0", "it's to save demo data!", 1024 * 1024); ;
                return db;
            }
            //显示所有数据库中的数据到页面上去
            function showAllTheData() {
                $("#tblData").empty();
                var db = getCurrentDb();
                db.transaction(function (trans) {
                    trans.executeSql("select * from Demo ", [], function (ts, data) {
                        if (data) {
                            for (var i = 0; i < data.rows.length; i++) {
                                appendDataToTable(data.rows.item(i));//获取某行数据的json对象
                            }
                        }
                    }, function (ts, message) {alert(message);var tst = message;});
                });
            }
            function appendDataToTable(data) {//将数据展示到表格里面
                //uName,title,words
                var txtName = data.uName;
                var txtTitle = data.title;
                var words = data.words;
                var strHtml = "";
                strHtml += "<tr>";
                strHtml += "<td>"+txtName+"</td>";
                strHtml += "<td>" + txtTitle + "</td>";
                strHtml += "<td>" + words + "</td>";
                strHtml += "</tr>";
                $("#tblData").append(strHtml);
            }
        </script>
    </head>
        <body>
            <table>
                <tr>
                    <td>用户名：</td>
                    <td><input type="text" name="txtName" id="txtName" required/></td>
                </tr>
                   <tr>
                    <td>标题：</td>
                    <td><input type="text" name="txtTitle" id="txtTitle" required/></td>
                </tr>
                <tr>
                    <td>留言：</td>
                    <td><input type="text" name="txtWords" id="txtWords" required/></td>
                </tr>
            </table>
            <input type="button" value="保存" id="btnSave"/>
            <hr/>
            <input type="button" value="展示所哟数据" οnclick="showAllTheData();"/>
            <table id="tblData">
            </table>
        </body>
    </html>

[HTML5_sessionStorage_localStorage]: http://blog.csdn.net/liuxiao723846/article/details/46561971
[Center]: /images/20210511/c63cf46a31d04f609d2e218e0cff0546.png