HTML5 Web SQL


Html5数据库API是以一个独立规范形式出现,它包含三个核心方法:

1、openDatabase:这个方法使用现有数据库或创建新数据库创建数据库对象。

2、transaction:这个方法允许我们根据情况控制事务提交或回滚。

3、executeSql:这个方法用于执行真实的SQL查询。

打开数据库

openDatabase方法可以打开已经存在的数据库,不存在则创建:

  1. var db = openDatabase('mydatabase', '2.0', my db', 2 * 1024);
openDatabasek中五个参数分别为:数据库名、版本号、描述、数据库大小、创建回调。创建回调没有也可以创建数据库。

执行查询

database.transaction()函数用来查询,下面将在mydatabase数据库中创建表t1:

  1. var db = openDatabase(' mydatabase ', '1.0', 'Test DB', 2 * 1024 * 1024);
  2. db.transaction(function (tx) {
  3. tx.executeSql('CREATE TABLE IF NOT EXISTS t1 (id unique, log)');
  4. });

插入操作

  1. var db = openDatabase('mydatabase', '2.0', my db', 2 * 1024);
  2. db.transaction(function (tx) {
  3. tx.executeSql('CREATE TABLE IF NOT EXISTS t1 (id unique, log)');
  4. tx.executeSql('INSERT INTO t1 (id, log) VALUES (1, "foobar")');
  5. tx.executeSql('INSERT INTO t1 (id, log) VALUES (2, "logmsg")');
  6. });
在插入新记录时,我们还可以传递动态值,如:

  1. var db = openDatabase(' mydatabase ', '2.0', 'my db', 2 * 1024);
  2. db.transaction(function (tx) {
  3. tx.executeSql('CREATE TABLE IF NOT EXISTS t1 (id unique, log)');
  4. tx.executeSql('INSERT INTO t1
  5. (id,log) VALUES (?, ?'), [e_id, e_log]; //e_id和e_log是外部变量
  6. });

读操作

如果要读取已经存在的记录,我们使用一个回调捕获结果,代码如下:

  1. var db = openDatabase(mydatabase, '2.0', 'my db', 2*1024);
  2.     db.transaction(function (tx) {
  3. tx.executeSql('CREATE TABLE IF NOT EXISTS t1 (id unique, log)');
  4. tx.executeSql('INSERT INTO t1 (id, log) VALUES (1, "foobar")');
  5. tx.executeSql('INSERT INTO t1 (id, log) VALUES (2, "logmsg")');
  6. });
  7. db.transaction(function (tx) {
  8. tx.executeSql('SELECT * FROM t1, [], function (tx, results) { var len = results.rows.length, i;
  9. msg = "<p>Found rows: " + len + "</p>";
  10. document.querySelector('#status').innerHTML += msg;
  11. for (i = 0; i < len; i++){
  12. alert(results.rows.item(i).log );
  13. }
  14. }, null);
  15. });

完整的示例

  1. <!DOCTYPE HTML>
  2. <html>
  3. <head>
  4. <script type="text/javascript">
  5. var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
  6. var msg;
  7. db.transaction(function (tx) {
  8. tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)');
  9. tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "foobar")');
  10. tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "logmsg")');
  11. msg = '<p>Log message created and row inserted.</p>';
  12. document.querySelector('#status').innerHTML = msg;
  13. });
  14. db.transaction(function (tx) {
  15. tx.executeSql('SELECT * FROM LOGS', [], function (tx, results) {
  16. var len = results.rows.length, i;
  17. msg = "<p>Found rows: " + len + "</p>";
  18. document.querySelector('#status').innerHTML += msg;
  19. for (i = 0; i < len; i++){
  20. msg = "<p><b>" + results.rows.item(i).log + "</b></p>";
  21. document.querySelector('#status').innerHTML += msg;
  22. }
  23. }, null);
  24. });
  25. </script>
  26. </head>
  27. <body>
  28. <div id="status" name="status">Status Message</div>
  29. </body>
  30. </html>
下面是在最新版本的Safari或Opera浏览器中产生的输出结果。

  1. Log message created and row inserted.
  2. Found rows: 2
  3. foobar
  4. logmsg