HTML5 Web SQL 數(shù)據(jù)庫(kù)
Web SQL 數(shù)據(jù)庫(kù) API 并不是 HTML5 規(guī)范的一部分,但是它是一個(gè)獨(dú)立的規(guī)范,引入了一組使用 SQL 操作客戶端數(shù)據(jù)庫(kù)的 APIs。
假定你是一個(gè)優(yōu)秀的 Web 開(kāi)發(fā)人員,如果是這樣的話,毫無(wú)疑問(wèn)你會(huì)很清楚 SQL 和 RDBMS 的概念。如果你仍然需要一個(gè) SQL 的議題,可以學(xué)習(xí)我們的?SQL 教程。
我們可以在最新版的 Safari,Chrome 和 Opera 中使用 Web SQL 數(shù)據(jù)庫(kù)。
核心方法
下面是規(guī)范中定義的三個(gè)核心方法。也會(huì)涵蓋在本教程中:
openDatabase:這個(gè)方法使用現(xiàn)有的數(shù)據(jù)庫(kù)或者新建的數(shù)據(jù)庫(kù)創(chuàng)建一個(gè)數(shù)據(jù)庫(kù)對(duì)象。
transaction:這個(gè)方法讓我們能夠控制一個(gè)事務(wù),以及基于這種情況執(zhí)行提交或者回滾。
executeSql:這個(gè)方法用于執(zhí)行實(shí)際的 SQL 查詢。
開(kāi)啟數(shù)據(jù)庫(kù)
如果數(shù)據(jù)庫(kù)已經(jīng)存在,openDatabase?方法負(fù)責(zé)開(kāi)啟數(shù)據(jù)庫(kù),如果不存在,這個(gè)方法會(huì)創(chuàng)建它。
使用下面的代碼可以創(chuàng)建并開(kāi)啟一個(gè)數(shù)據(jù)庫(kù):
var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024);
上面的方法接受下列五個(gè)參數(shù):
數(shù)據(jù)庫(kù)名稱
版本號(hào)
描述文本
數(shù)據(jù)庫(kù)大小
創(chuàng)建回調(diào)
最后也是第五個(gè)參數(shù),創(chuàng)建回調(diào)會(huì)在創(chuàng)建數(shù)據(jù)庫(kù)后被調(diào)用。然而,即使沒(méi)有這個(gè)特性(功能),運(yùn)行時(shí)仍然會(huì)創(chuàng)建數(shù)據(jù)庫(kù)以及正確的版本。
執(zhí)行查詢
執(zhí)行查詢需要使用 database.transaction() 函數(shù)。這個(gè)函數(shù)需要一個(gè)參數(shù),它是一個(gè)負(fù)責(zé)實(shí)際執(zhí)行查詢的函數(shù),如下所示:
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)');
});
上面的查詢語(yǔ)句會(huì)在 'mydb' 數(shù)據(jù)庫(kù)中創(chuàng)建一個(gè)叫做的 LOGS 的表。
插入操作
為了在表中創(chuàng)建條目,我們?cè)谏厦娴睦又屑尤牒?jiǎn)單的 SQL 查詢,如下所示:
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)');
? tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "foobar")');
? tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "logmsg")');
});
創(chuàng)建條目時(shí)還可以傳遞如下所示的動(dòng)態(tài)值:
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)');
?tx.executeSql('INSERT INTO LOGS
? ? ? ? ? ? ? ? ? ? ? ?(id,log) VALUES (?, ?'), [e_id, e_log];
});
這里的 e_id 和 e_log 是外部變量,executeSql 會(huì)映射數(shù)組參數(shù)中的每個(gè)條目給 "?"。
讀取操作
要讀取已經(jīng)存在的記錄,我們可以使用回調(diào)來(lái)捕獲結(jié)果,如下所示:
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)');
? tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "foobar")');
? tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "logmsg")');
});
db.transaction(function (tx) {
? tx.executeSql('SELECT * FROM LOGS', [], function (tx, results) {
? var len = results.rows.length, i;
? msg = "<p>Found rows: " + len + "</p>";
? document.querySelector('#status').innerHTML += ?msg;
? for (i = 0; i < len; i++){
? ? ?alert(results.rows.item(i).log );
? }
}, null);
});
最終示例
最后,然我們把這個(gè)例子放到如下所示的完整 HTML5 文檔中,然后嘗試在 Safari 瀏覽器中運(yùn)行它:
<!DOCTYPE HTML> <html> <head> <script type="text/javascript"> var db = openDatabase('mydb', '1.0', 'Test DB', 2 * 1024 * 1024); var msg; db.transaction(function (tx) { tx.executeSql('CREATE TABLE IF NOT EXISTS LOGS (id unique, log)'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (1, "foobar")'); tx.executeSql('INSERT INTO LOGS (id, log) VALUES (2, "logmsg")'); msg = '<p>Log message created and row inserted.</p>'; document.querySelector('#status').innerHTML = msg; }); db.transaction(function (tx) { tx.executeSql('SELECT * FROM LOGS', [], function (tx, results) { var len = results.rows.length, i; msg = "<p>Found rows: " + len + "</p>"; document.querySelector('#status').innerHTML += msg; for (i = 0; i < len; i++){ msg = "<p><b>" + results.rows.item(i).log + "</b></p>"; document.querySelector('#status').innerHTML += msg; } }, null); }); </script> </head> <body> <div id="status" name="status">Status Message</div> </body> </html>
在最新版的 Safari 或者 Opera 瀏覽器中這會(huì)生成如下所示結(jié)果:
Log message created and row inserted.
Found rows: 2
foobar
logmsg
刪除記錄
刪除記錄使用的格式如下:
db.transaction(function (tx) {
? ?tx.executeSql('DELETE FROM LOGS ?WHERE id=1');
});
刪除指定的數(shù)據(jù)id也可以是動(dòng)態(tài)的:
db.transaction(function(tx) {
? ?tx.executeSql('DELETE FROM LOGS WHERE id=?', [id]);
});
更新記錄
更新記錄使用的格式如下:
db.transaction(function (tx) {
? ?tx.executeSql('UPDATE LOGS SET log='www.w3cschool.cc' WHERE id=2');
});
更新指定的數(shù)據(jù)id也可以是動(dòng)態(tài)的:
db.transaction(function(tx) {
? ?tx.executeSql('UPDATE LOGS SET log='www.w3cschool.cc' WHERE id=?', [id]);
});