猿变实验室之猿变开发手册-HTML5语法入门-HTML5 Web SQL

Web SQL 数据库 API 并不是 HTML5 规范的一部分，但是它是一个独立的规范，引入了一组使用 SQL 操作客户端数据库的 APIs。

如果你是一个 Web 后端程序员，应该很容易理解 SQL 的操作。

你也可以参考我们的 SQL 教程，了解更多数据库操作知识。

Web SQL 数据库可以在最新版的 Safari, Chrome 和 Opera 浏览器中工作。

核心方法

以下是规范中定义的三个核心方法：

openDatabase：这个方法使用现有的数据库或者新建的数据库创建一个数据库对象。
transaction：这个方法让我们能够控制一个事务，以及基于这种情况执行提交或者回滚。
executeSql：这个方法用于执行实际的 SQL 查询。

打开/创建数据库

我们可以使用 openDatabase() 方法来打开已存在的数据库，如果数据库不存在，则会创建一个新的数据库

openDatabase() 方法对应的五个参数说明：

数据库名称
版本号
描述文本
数据库大小
创建回调

第五个参数，创建回调会在创建数据库后被调用。

使用代码如下：

<script>
 try{
      var db = openDatabase('mydb', '1.0',
                            'my database',
                             2 * 1024 * 1024,
                             function(x){
                                 document.write("数据库创建成功")
                              }
                           );
  } catch (e) {
      document.write(e)
  }

</script>

WEB SQL查询操作

执行操作使用database.transaction() 函数

<script>
var db = openDatabase('mydb', '1.0', 'my database', 2 * 1024 * 1024); 
db.transaction(
     //ts - 传入Trans
     function (ts) {
         ts.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); 
    }
);
</script>

上面的语句执行后会创建'LOGS' 数据表

WEB SQL插入数据

在执行上面的创建表语句后，我们可以插入一些数据：

<script>
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); 
db.transaction(
   function (ts) 
   {
      ts.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); 
      // 插入两条数据
      ts.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "Python轻松学")'); 
      ts.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "www.Python-XP.com")'); 
   }
);
</script>

我们也可以使用动态值来插入数据：

<script>
var db = openDatabase('mydb', '1.0', 'my database', 2 * 1024 * 1024); 
db.transaction(
    function (ts)
    {
        ts.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)');
        ts.executeSql('INSERT INTO LOGS (id,log) VALUES (?, ?)', [e_id, e_log]); 
    }
);
</script>

实例中的 e_id 和 e_log 是外部变量，executeSql 会映射数组参数中的每个条目给 "?"。

WEB SQL读取数据

以下实例演示了如何读取数据库中已经存在的数据：

<div id="status"></div>

<hr />
<ul id="results"></ul>

<script> 
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); 
db.transaction( 
    function (ts) { 
        ts.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); 
        ts.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "pthon-xp.com")');
        ts.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "轻松学python")'); 
    } 
); 
db.transaction(
    function (ts) { 
        ts.executeSql('SELECT * FROM LOGS', [], 
            function (ts, results) { 
                var len = results.rows.length, i; msg = "<p>查询记录条数: " + len + "</p>";
                document.querySelector('#status').innerHTML += msg; 
                lists = document.querySelector('#results')
                lists.innerHTML = ""
                for (i = 0; i < len; i++){ 
                    row_data = results.rows.item(i)
                    lists.innerHTML += "<li>" + row_data.id + ":::"+row_data.log + "</li>"; 
 
                } 
            }, 
            null ); 
    } 
); 
</script>

WEB SQL删除记录

删除记录使用的格式如下：

db.transaction(function (ts) {
    ts.executeSql('DELETE FROM LOGS  WHERE id=1');
});

删除指定的数据id也可以是动态的：

db.transaction(function(ts) {
    ts.executeSql('DELETE FROM LOGS WHERE id=?', [id]);
});

WEB SQL更新记录

更新记录使用的格式如下：

db.transaction(function (ts) {
    ts.executeSql('UPDATE LOGS SET log=\'www.python.org\' WHERE id=2');
});

更新指定的数据id也可以是动态的：

db.transaction(function(ts) {
    ts.executeSql('UPDATE LOGS SET log=\'www.python.org\' WHERE id=?', [id]);
});

WEB SQL完整实例

<p id="tips"></p>
<div id="status"></div>
<hr />
<ul id="results"></ul>
<hr>
<button onclick="del(1)">删除</button> <button onclick="update(2, '平哥编程')">更新</button>
<script>
var db = openDatabase('mydb', '1.0', 'cms', 2 * 1024 * 1024); 
var tips = document.querySelector('#tips')
var msg; 
//  插入数据
// 数据库初始化
db.transaction(
    function (ts) {
        ts.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); 

        ts.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "Python轻松学")'); 
        ts.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "python-xp.com")'); 

        msg = '数据表已创建，且插入了两条数据';
        tips.innerHTML = msg; 
        show_data()
    }

); 

// 删除
function del(id){
    db.transaction(
        function (ts) { 
            ts.executeSql('DELETE FROM LOGS WHERE id=?', [id]); 
            msg = '删除 id 为 '+ id + '的记录'; 
            tips.innerHTML = msg;
            show_data()            
        }
    ); 
}

// 更新 
function update(id, newlog){
    db.transaction(
        function (ts) { 
            ts.executeSql('UPDATE LOGS SET log=? WHERE id=?', [newlog, id]);
            msg = '<p>更新 id 为 '+ id + ' 的记录。</p>'; 
            tips.innerHTML = msg;
            show_data() 
    }
);
}

// 显示数据
function show_data(){
    db.transaction(
        function (ts) { 
            ts.executeSql('SELECT * FROM LOGS', [], 
                function (ts, results) { 
                    var len = results.rows.length, i; 
                    msg = "<p>查询记录条数: " + len + "</p>"; 
                    document.querySelector('#status').innerHTML = msg;
                    lists =  document.querySelector('#results')
                    lists.innerHTML = ""
                    for (i = 0; i < len; i++){ 
                        row_data = results.rows.item(i)
                        row = "<li>" + row_data.id + ":::" + row_data.log + "</li>";
                        lists.innerHTML += row; 
                    } 
             }, null); 
          }
      );
}
</script>

HTML5 Web SQL