WebSQL
# WebSQL
WebSQL 数据库 API 并不是 HTML5 规范的一部分,但是它是一个独立的规范,引入了一组使用 SQL 操作客户端数据库的 APIs。
如果你之前接触过诸如像 MySQL 这样的关系型数据库,学习过 SQL 语言,那么 WebSQL 对于你来讲没有任何的难度。
最新版的 Safari, Chrome 和 Opera 浏览器都支持 WebSQL。
在 WebSQL 中,有 3 个核心方法:
openDatabase:这个方法使用现有的数据库或者新建的数据库创建一个数据库对象。
transaction:这个方法让我们能够控制一个事务,以及基于这种情况执行提交或者回滚。
executeSql:这个方法用于执行实际的 SQL 查询。
# 打开数据库
我们可以使用 openDatabase( ) 方法来打开已存在的数据库,如果数据库不存在,则会创建一个新的数据库,使用代码如下:
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
在上面的代码中,我们尝试打开一个名为 mydb 的数据库,因为第一次不存在此数据库,所以会创建该数据库,版本号为 1.0,大小为 2M。
openDatabase( ) 方法对应的 5 个参数:
数据库名称
版本号
描述文本
数据库大小
创建回调
第 5 个参数,创建回调会在创建数据库后被调用。
# 执行操作
执行操作使用 database.transaction( ) 函数:
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
db.transaction(function (tx) {
tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)');
});
上面的语句执行后会在 'mydb' 数据库中创建一个名为 LOGS 的表。
该表存在 2 个字段 id 和 log,其中 id 是唯一的。
# 插入数据
在执行上面的创建表语句后,我们可以插入一些数据:
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
db.transaction(function (tx) {
tx.executeSql('CREATE TABLE IF NOT EXISTS STU (id unique, name, age)');
tx.executeSql('INSERT INTO STU (id, name, age) VALUES (1, "张三", 18)');
tx.executeSql('INSERT INTO STU (id, name, age) VALUES (2, "李四", 20)');
});
在上面的代码中,我们创建了一张名为 STU 的表,该表存在 3 个字段 id,name 和 age。
之后我们往这张表中插入了 2 条数据。
我们也可以使用动态值来插入数据:
var stuName = "谢杰";
var stuAge = 18;
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
db.transaction(function (tx) {
tx.executeSql('CREATE TABLE IF NOT EXISTS STU (id unique, name, age)');
// tx.executeSql('INSERT INTO STU (id, name, age) VALUES (1, "张三", 18)');
// tx.executeSql('INSERT INTO STU (id, name, age) VALUES (2, "李四", 20)');
tx.executeSql('INSERT INTO STU (id, name, age) VALUES (3, ?, ?)', [stuName, stuAge]);
});
在上面的代码中,我们使用动态值的方式插入了一条数据,实例中的 stuName 和 stuAge 是外部变量,executeSql 会映射数组参数中的每个条目给 "?"。
注意:由于上一次操作已经插入了 id 为 1 和 2 的数据,所以这一次插入内容时,要将前面两次插入语句注释调,否则插入操作不会成功。因为这里是一个事务,前面失败了会导致后面也失败。
# 读取数据
以下实例演示了如何读取数据库中已经存在的数据:
<div id="status"></div>
var stuName = "谢杰";
var stuAge = 18;
// 打开数据库
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
// 插入数据
db.transaction(function (tx) {
tx.executeSql('CREATE TABLE IF NOT EXISTS STU (id unique, name, age)');
tx.executeSql('INSERT INTO STU (id, name, age) VALUES (1, "张三", 18)');
tx.executeSql('INSERT INTO STU (id, name, age) VALUES (2, "李四", 20)');
tx.executeSql('INSERT INTO STU (id, name, age) VALUES (3, ?, ?)', [stuName, stuAge]);
});
// 读取操作
db.transaction(function (tx) {
tx.executeSql('SELECT * FROM STU', [], function (tx, results) {
var len = results.rows.length, i;
msg = "<p>查询记录条数: " + len + "</p>";
document.querySelector('#status').innerHTML += msg;
for (i = 0; i < len; i++) {
msg = "<p><b>" + results.rows.item(i).name + ":" + results.rows.item(i).age + "</b></p>";
document.querySelector('#status').innerHTML += msg;
}
}, null);
});
在上面的代码中,第二个部分是读取数据的操作。这里我们仍然是使用的 executeSql( ) 方法来执行的 SQL 命令,但是用法又不一样了。是时候来看一下完整的 executeSql( ) 方法是什么样了。
executeSql(sqlStatement, arguments, callback, errorCallback)
该方法完整的语法实际上是接收 4 个参数,分别是:
- SQL 语句
- 参数
- 执行 SQL 语句后的回调
- 错误回调
因此在上面的示例中,我们 executeSql( ) 的第三个参数就是执行了 SQL 语句后的回调。我们在回调中可以通过 results.rows 拿到该表中的数据,之后对数据进行业务需求的操作即可。
# 删除数据
删除数据也是使用 SQL 中的语法,同样也支持动态指定的方式。
var stuID = 2;
// 删除操作
db.transaction(function (tx) {
tx.executeSql('DELETE FROM STU WHERE id=1');
tx.executeSql('DELETE FROM STU WHERE id=?', [stuID]);
});
在上面的代码中,我们删除了 id 为 1 和 2 的两条数据,其中第二条是动态指定的。
# 修改数据
要修改数据也是使用 SQL 中的语法,同样也支持动态指定的方式。
var stuID = 3;
// 更新操作
db.transaction(function (tx) {
tx.executeSql('UPDATE STU SET name=\'王羲之\' WHERE id=3');
tx.executeSql('UPDATE STU SET age=21 WHERE id=?', [stuID]);
});
在上面的代码中,我们修改了 id 为 3 的学生,名字修改为“王羲之”,年龄修改为 21。
# 总结
目前来看,WebSQL 已经不再是 W3C 推荐规范,官方也已经不再维护了。原因说的很清楚,当前的 SQL 规范采用 SQLite 的 SQL 方言,而作为一个标准,这是不可接受的。
另外,WebSQL 使用 SQL 语言来进行操作,更像是一个关系型数据库,而 IndexedDB 则更像是一个 NoSQL 数据库, 这也是目前 W3C 强推的浏览端数据库解决方案。
所以本文不再对 WebSQL 做过多的介绍。
如果有兴趣的同学,可以参阅下面的资料进行扩展阅读:
- View Web SQL data:https://developer.chrome.com/docs/devtools/storage/websql/?utm_source=devtools#run(需要搭梯子)
- CSDN WebSQL 最全详解:https://blog.csdn.net/weixin_45389633/article/details/107308968
-EOF-