websql的使用

发表于 2017-07-15 更新于 2018-03-27

白嘉轩后来引以豪壮的是一生里娶过七房女人。 ——陈忠实《白鹿原》

需要注意的是，HTML5已经会放弃Web SQL Database 放弃的原因如下：

This document was on the W3C Recommendation track but specification work has stopped. The specification reached an impasse: all interested implementors have used the same SQL backend (Sqlite), but we need multiple independent implementations to proceed along a standardisation path.
大概意思是：
该文件是W3C推荐标准，但规范的制定工作已经停止。该规范陷入僵局：所有感兴趣的实现者都使用了相同的SQL后端（SQLite的），但我们需要多个独立的实现沿着规范化的路径进行。

Web SQL Database 是一个运行在Html5环境下可以用Js执行CRUD的Web数据库。
在介绍它的使用前，先搞清几个误区：

1、 webSQL是运行在浏览器环境的一个数据库，其数据持久化在客户端。所以不要试图连接自己的mySQL等真正意义上的数据库。不仅仅是权限，更多的是安全问题。
2、对webSQL的修改，只是修改了了本地数据，如果要将数据持久化到远程数据库服务器，还是要走接口的。
3、对于简单的数据存储，能用localStorage就，就不要再用webSQL了。除非是处理关系型数据库，这个时候用webSQL最合适不过了。

在使用webSQL对数据进行增删查改之前，先介绍三个核心方法：

1、openDatabase：这个方法使用现有数据库或创建新数据库创建数据库对象。
2、transaction：这个方法允许我们根据情况控制事务提交或回滚。
3、executeSql：这个方法用于执行真实的SQL查询。

第一步：打开连接并创建数据库

var config = {  
     name: 'student',
     version: "1.0",
     desc: '学生表',
     size: 1024 * 1024
 };
var dataBase = window.openDatabase(config.name, config.version, config.desc, config.size,function () {});  
if (!dataBase) {  
    alert("数据库创建失败！");
} else {
    alert("数据库创建成功！");
}

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

1，数据库名称。
2，版本号目前为1.0(暂时不理解)
3，对数据库的描述。
4，设置数据的大小。
5，回调函数(可省略)。
初次调用时创建数据库，以后就是建立连接了。创建的是一个sqllite数据库，完全可以用sqllite developer 打开文件，可以看到里面的数据。

第二步：创建数据表

this.createTable=function() {  
  dataBase.transaction( function(tx) { 
    tx.executeSql(
        "create table if not exists stu (id REAL UNIQUE, name TEXT)", 
        [], 
        function(tx,result){ alert('创建stu表成功'); }, 
        function(tx, error){ alert('创建stu表失败:' + error.message); 
    });
 });
}

executeSql函数有四个参数，其意义分别是：
1）表示查询的字符串，使用的SQL语言是SQLite 3.6.19。
2）插入到查询中问号所在处的字符串数据。
3）成功时执行的回调函数。返回两个参数：tx和执行的结果。
4）一个失败时执行的回调函数。返回两个参数：tx和失败的错误信息。

第三步：执行增删改查

添加数据：

this.insert = function () {  
  dataBase.transaction(function (tx) {
            tx.executeSql(
        "insert  into  stu (id, name) values(?, ?)",
        [id, '徐明祥'],
        function () { alert('添加数据成功'); },
        function (tx, error) { alert('添加数据失败: ' + error.message); 
        } );
    });

查询数据

this.query = function () {  
  dataBase.transaction(function (tx) {
            tx.executeSql(
        "select  *  from  stu", [],
         function (tx, result) {  //执行成功的回调函数
             //在这里对result 做你想要做的事情吧...........
            },
         function (tx, error) {
            alert('查询失败: ' + error.message);
         } );
      });
}

上面代码中执行成功的回调函数有一参数result。 result：查询出来的数据集。其数据类型为 SQLResultSet ，就如同C#中的DataTable。
SQLResultSet 的定义为：

interface SQLResultSet { 
readonly attribute long insertId; 
readonly attribute long rowsAffected; 
readonly attribute SQLResultSetRowList rows; 
};

其中最重要的属性—SQLResultSetRowList 类型的 rows 是数据集的“行” 。
rows 有两个属性：length、item 。
故，获取查询结果的某一行某一列的值：result.rows[i].item[fieldname] 。

更新数据

this.update = function (id, name) {  
    dataBase.transaction(function (tx) {
            tx.executeSql(
        "update  stu  set  name =  ?  where  id= ?",
        [name, id],
         function (tx, result) {
         },
        function (tx, error) {
            alert('更新失败: ' + error.message);
        });
   });
}

删除数据

this.del = function (id) {
           dataBase.transaction(function (tx) {
           tx.executeSql(
       "delete  from  stu  where  id= ?",
       [id],
        function (tx, result) {
        },
       function (tx, error) {
           alert('删除失败: ' + error.message);
       });
    });
  }

删除数据表

this.dropTable = function () {
             dataBase.transaction(function (tx) {
           tx.executeSql('drop  table  stu');
       });
   }