HTML 5 Web SQL Database初探

《從零開始構建HTML 5頁面》一文中,我們瞭解到HTML 5的一些新增特性並通過實例打造了一個完整的HTML 5頁面。但HTML 5標準不只侷限於傳統的標記語言,它還擁有很多讓人期待的API接口,利用這些接口,開發者可以創建更加豐富、更加引人注目的應用程序。之前我們介紹過支持文件拖放上傳功能的HTML 5 File API,今天,我們一起來了解HTML 5的Web SQL Database API,使用本地和會話存儲實現簡單的對象持久化。

    對於HTML 5,也許最爲有用的就是它新推出的“Web Storage”(Web 存儲)API。對簡單的關鍵值對(比如應用程序設置)或簡單對象(如應用程序狀態)進行存儲,使用本地和會話存儲能夠很好地完成,但是在對瑣碎的關係數據進行處理之外,它就力所不及了。而這正是 HTML 5 的“Web SQL Database”API 接口的應用所在。

    先提個醒,該文下面的內容需要讀者對 JavaScript 和麪對對象編程(尤其是匿名內的內部函數)以及SQL具有很好的理解。

打開鏈接

爲了打開一個連接,我們執行以下代碼:

  1. db = openDatabase("ToDo""0.1""A list of to do items.", 200000); 

以上代碼創建了一個數據庫對象 db,名稱是 Todo,版本編號爲0.1。db 還帶有描述信息和大概的大小值。用戶代理(user agent)可使用這個描述與用戶進行交流,說明數據庫是用來做什麼的。利用代碼中提供的大小值,用戶代理可以爲內容留出足夠的存儲。如果需要,這個大小是可以改變的,所以沒有必要預先假設允許用戶使用多少空間。

   爲了檢測之前創建的連接是否成功,你可以檢查那個數據庫對象是否爲null:

  1. if(!db)  
  2.      alert("Failed to connect to database."); 

    絕不可以假設該連接已經成功建立,即使過去對於某個用戶它是成功的。爲什麼一個連接會失敗,存在多個原因。也許用戶代理出於安全原因拒絕你的訪問,也許設備存儲有限。面對活躍而快速進化的潛在用戶代理,對用戶的機器、軟件及其能力作出假設是非常不明智的行爲。比如,當用戶使用手持設備時,他們可自由處置的數據可能只有幾兆字節。

執行查詢

執行一個查詢,你可以使用database.transaction()函數。該函數具有單一參數,負責查詢實際執行的函數。

該函數(通常是匿名的)具有一個類型事務的參數。

  1. db.transactionfunction(tx) { 

該事務具有一個函數:executeSql。這個函數使用四個參數:表示查詢的字符串,插入到查詢中問號所在處的字符串數據(很像 Java 的預先準備好的語句),一個成功時執行的函數和一個失敗時執行的函數。

  1. tx.executeSql("SELECT COUNT(*) FROM ToDo", [], 
  2. function(result){}, 
  3. function(tx, error){}); 
  4. '查詢表todo中的條目數量



查詢成功時

    當查詢成功執行時,應用程序跳轉至一個具有一對參數的查詢,一個是 transaction,另一個是它蒐集的 results。對於實際上將你的數據傳遞至用戶,這是非常完美的,比如顯示 ToDo 列表。有關這個話題後面再講。

查詢失敗失敗時

    當查詢沒能執行時執行。由於你將 transaction  對象作爲函數的第一個參數進行傳遞,當出現錯誤時你可以繼續執行查詢。例如,如果是因爲缺少表格(table)而查詢無法運行,這是創建一個表格並在此執行該語句的絕佳時機。從該函數的第二個參數,你可以獲得有關該錯誤的信息(包括描述)。

示例

    假設我們想要使用上面的例子,想要查詢數據庫中的某個表格,如果該表格不存在,我們就創建一個表格。

在這個示例中,我們將調用具有一個函數參數的 db.transaction()。這個參數中,我們調用 tx.executeSql()。如果這個步驟成功,我們不做任何操作(因此是一個null參數)。或者我們將該事務和執行失敗的函數一起傳遞,並再次調用 tx.executeSql()。這一次使用創建查詢。

  1. db.transactionfunction(tx) { tx.executeSql("SELECT COUNT(*) FROM ToDo",
     [], 
    nullfunction(tx, error) { tx.executeSql("CREATE TABLE ToDo (id REAL UNIQUE, label TEXT, timestamp REAL)",
     [], 
    nullnull); } ); } ); 
  2.  

    使用所有這些內部方法,可能有點麻煩,所以你也許想在外部創建一個調用 db.transaction() 的函數。比如,我們可以讓錯誤函數是自包含的,並將其命名爲“createToDoTable()”。

插入

爲了讓代碼更加簡潔和安全,Web SQL Database API 允許你爲  transaction.executeSql() 函數提供字符串數據,用以表示調用的 SQL 語句中的變量。我們使用以下的代碼進行演示:

  1. db.transactionfunction(tx) { tx.executeSql("INSERT INTO ToDo (label, timestamp) values(?, ?)"
    [label, new 
    Date().getTime()], nullnull); } ); 
  2.  ‘數組 [label, new Date().getTime()]

    在這個示例中,第一個參數中的兩個問號將被後面數組中對應的項替代。第一個是爲該任務設置的標籤(也許是我們之前在代碼中定義的一個變量),以及調用函數生成的時間戳。

執行該查詢,其結果與下面語句類似:

  1. INSERT INTO ToDo (label, timestampvalues ("Test", 1265925077487) 

對結果進行處理

    成功執行的函數對結果對象包含集合或行。每一列表示一個結果。該結果包含分配給它的一組值,表示該特定結果的數據庫中的每一列的值。通過調用 result.rows.item(i) 可以訪問一個行,其中 i 是你想要查詢的行的指針。想要從一行中選擇一個值,你可以傳遞給該行一個數組格式的字符串指針,它表示你需要查詢的列。例如,如果想要標籤(label)列,我們可以調用  row['label']。

以下代碼使用結果對象來輸出一個查詢的結果:

  1. db.transactionfunction(tx) { tx.executeSql("SELECT * FROM ToDo", [],  
  2.  function(tx, result) { for(var i = 0; i < result.rows.length; i++)   
  3. { document.write('' + result.rows.item(i)['label'] + ' /*想要從一行中選擇一個值
    '); } }, null); } ); </br >
  4.  

結論

    需要注意的是,如果不是絕對需要的情況,不要使用 Web SQL Database。這不是因爲它們的技術高高在上,而是因爲它們會讓你的代碼更加複雜。對於大多數情況,本地存儲或會話存儲就能夠完成相應的任務,尤其是你能夠保持對象狀態持久化的情況。

    正如前面所說,通過這些HTML 5 Web SQL Database API 接口,你可以獲取許多功能。我相信,幾年以後會出現一些非常優秀的、建立在這些 API 之上的應用程序。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章