通過90行程式碼學會HTML5 WebSQL的4種基本操作

i042416發表於2018-08-20

Web SQL資料庫API是一個獨立的規範，在瀏覽器層面提供了本地對結構化資料的儲存，已經被很多現代瀏覽器支援了。

我們通過一個簡單的例子來了解下如何使用Web SQL API在瀏覽器端建立資料庫表並儲存資料。

<!doctype html><html><head>
    <script>
    var end;    function setupDB() {        return this.createDatabase().then(createTable).then(insertEntry).then(readEntry).then(printResult);
    }    function createTable() {        return new Promise(function(resovle, reject) {            console.log("prepare to create table..." + Date.now());            this._db.transaction(function(query) {
                query.executeSql('create table if not exists user(id unique, user, passwd)');
            });
            setTimeout(_createTableOK.bind(this, resovle), 1000);
        });
    }    function _createTableOK(resovle) {        console.log("table created successfully..." + Date.now());
        resovle();
    }    function createDatabase() {        return new Promise(function(resovle, reject) {            console.log("prepare to create database..." + Date.now());            this._db = openDatabase('mydb', '1.0', 'JerryTestdb', 1024);
            setTimeout(_createDatabaseOK.bind(this, resovle), 1000);
        });
    }    function _createDatabaseOK(resovle) {        console.log("database created successfully..." + Date.now());
        resovle(this._db);
    }    function insertEntry() {        return new Promise(function(resolve, reject) {            this._db.transaction(function(query) {
                query.executeSql("insert into user values (1,'Jerry','1234')");
            });
            setTimeout(_insertEntryOK.bind(this, resolve), 1000);
        });
    }    function _insertEntryOK(resolve) {        console.log("entry inserted to table successfully..." + Date.now());
        resolve();
    }    function readEntry() {        return new Promise(function(resolve, reject) {            this._db.transaction(function(query) {
                    query.executeSql('select * from user', [], function(u, results) {
                        setTimeout(_readEntryOK.bind(this, resolve, results), 1000);
                    }); // end of query.executeSql
                } // end of function(query)
            ); // end of this._db.transaction
        });
    }    function _readEntryOK(resolve, oResult) {        console.log("entry readed from DB successfully..." + Date.now());
        resolve(oResult);
    }    function printResult(oResults) {        for (var i = 0; i < oResults.rows.length; i++) {            document.writeln('id: ' + oResults.rows[i].id);            document.writeln('user: ' + oResults.rows[i].user);            document.writeln('passwd: ' + oResults.rows[i].passwd);
        }
        end = true;
    }    function work() {        if (end) {
            clearInterval(handle);
        } else {            console.log(" working..." + Date.now());
        }
    }
    setupDB();    var handle = setInterval(work, 200);    </script></head></html>

在瀏覽器裡執行這個應用，會建立一個名叫mydb的資料庫，裡面一張名為“user”的資料庫表，並且插入一條記錄進去，然後從資料庫表中讀取中來，列印在瀏覽器上。

通過90行程式碼學會HTML5 WebSQL的4種基本操作

下面就來分析下這90行程式碼。

程式的入口是setupDB這個函式，下面的setInterval起了1個間隔為200毫秒的週期執行函式，為了模擬當前瀏覽器除了進行Web SQL資料庫外，還有其他的任務再執行。

通過90行程式碼學會HTML5 WebSQL的4種基本操作

setupDB

用promise實現了一個鏈式呼叫，第九行程式碼從語義上來說很容易理解：首先建立資料庫(createDatabase)，然後建立資料庫表(createTable)，然後插入一條記錄到資料庫表裡(insertEntry), 然後馬上把剛才插入表裡的記錄讀出來(readEntry)。最後列印到瀏覽器上。

大家看我第16行的_createDatabaseOK的函式延時1秒執行，僅僅是為了演示WebSQL API 非同步呼叫的最佳實踐。

createDatabase函式的第15行，呼叫了Web SQL API的openDatabase，建立了一個名為mydb的資料庫。openDatabase會返回一個資料庫控制程式碼，我們儲存在屬性_db裡以便後續使用。

通過90行程式碼學會HTML5 WebSQL的4種基本操作