嚴格說來,Web SQL Database 並不屬於 HTML5 規範本身,而是獨立的一份規格。它提供了一組 API,讓網頁得以操作用戶端資料庫,當年 Safari、Chrome、Firefox、Opera 等主流瀏覽器都已支援。
它真正吸引人的地方在於:你可以用幾乎等同 MySQL 的語法操作瀏覽器內的資料庫。對習慣後端開發的人來說,這種熟悉感讓人很快就上手。
openDatabase:開啟既有資料庫,若不存在則建立一個新的,並回傳資料庫物件。transaction:控制交易,讓你能依狀況決定提交或回滾。executeSql:執行真正的 SQL 指令。var dataBase = openDatabase("student", "1.0", "學生表", 1024 * 1024, function () {});
if (!dataBase) {
alert("資料庫建立失敗!");
} else {
alert("資料庫建立成功!");
}
openDatabase 的五個參數依序是:
第一次呼叫時建立資料庫,之後再呼叫就是建立連線。建立起來的檔案實際落在本機,路徑類似:
C:\Users\Administrator\AppData\Local\Google\Chrome\User Data\Default\databases\http_localhost_4987
底層就是一個 SQLite 檔案,可以用 SQLiteSpy 這類免費工具打開來直接檢視內容,除錯時非常方便。
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 同樣收四個參數:
tx 與結果物件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 就是查詢結果集,型別為 SQLResultSet,概念上等同 C# 的 DataTable。它的定義如下:
interface SQLResultSet {
readonly attribute long insertId;
readonly attribute long rowsAffected;
readonly attribute SQLResultSetRowList rows;
};
其中最關鍵的是 rows,也就是資料的「列」。它有兩個成員:length 與 item。因此取值第 i 列的某個欄位就寫成:
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');
});
}
這套 API 的開發體驗確實順手,但要知道一件事:W3C 早在 2010 年就停止維護 Web SQL 的規格,理由是它不鼓勵廠商各自綁定特定的 SQL 實作。後續標準轉向 IndexedDB 這類鍵值式的方案,主流瀏覽器也逐步把 Web SQL 標記為不建議使用。
所以如果你的目標是新專案,建議直接評估 IndexedDB;若是維護既有的老系統,上面這套增刪改查的寫法仍然能派上用場,理解它的運作模式也有助於你判斷遷移的成本。