DIV CSS 佈局教程網

您现在的位置: DIV+CSS佈局教程網 >> 網頁腳本 >  >> HTML基礎知識 >> HTML5詳解
HTML5 本機儲存之 Database Storage:用 Web SQL 做一份通訊錄
編輯:HTML5詳解     

上一篇介紹了 Web Storage(localStorage 與 sessionStorage),那是 key-value 形式的儲存。除了它之外,HTML5 早期還規劃過另一條路:直接在瀏覽器裡跑一個本機關聯式資料庫。做法是基於 SQLite——一種單檔型的輕量資料庫,做過 iOS/Android 開發的人應該對它不陌生。

先把重要前提講在前面:Web SQL Database 這套規格已被 W3C 於 2010 年停止維護,Chrome、Safari 之外的主要瀏覽器都沒有實作,Edge 與 Firefox 完全不支持。所以下面內容請當成歷史知識與維護舊專案時的參考;新專案要存結構化資料,應該直接用 IndexedDB。理解了 Web SQL 的寫法,再去看 IndexedDB 的物件導向 API 也會順手很多。

1. 用 openDatabase 建立連線

var db = openDatabase(databasename, version, description, size)

四個參數的作用:

  • databasename:資料庫名稱。
  • version:版本號,可留空字串。
  • description:資料庫描述。
  • size:配置給這個資料庫的空間大小(位元組)。

2. 用 transaction 開啟交易

db.transaction(function (tx) {
  // 在這裡執行資料庫操作
});

transaction 接受一個回呼函數,並把交易物件 tx 交給你,所有 SQL 都透過它執行。包在交易裡的好處是失敗時能整批回滾,不會留下半套資料。

3. 用 executeSql 下指令

tx.executeSql(sqlQuery, [value1, value2, ...], dataHandler, errorHandler)

四個參數:

  • sqlQuery:要執行的 SQL,可以是 create、select、update、delete。
  • [value1, value2, ...]:SQL 中的參數值。寫法是在 SQL 裡用 ? 佔位,再把值依序放進這個陣列——這就是參數化查詢,能避免 SQL Injection,也省去自己處理引號跳脫。
  • dataHandler:成功時的回呼,可從中取得結果集。
  • errorHandler:失敗時的回呼。

實作:一份可新增、列出、刪除的通訊錄

目標功能:新增聯絡人(姓名、手機、公司、建立時間)、列出所有聯絡人、刪除指定聯絡人。先準備頁面骨架:

<!DOCTYPE Html>
<Html>
<head>
<meta charset="utf-8"/>
<title>HTML5 本機儲存之本地資料庫篇</title>
<style>
.addDiv {
  border: 2px dashed #ccc;
  width: 400px;
  text-align: center;
}
</style>
</head>
<body onload="loadAll()">
<div class="addDiv">
<label for="user_name">姓名:</label>
<input type="text" id="user_name" name="user_name" class="text"/>
<br/>
<label for="mobilephone">手機:</label>
<input type="text" id="mobilephone" name="mobilephone"/>
<br/>
<label for="company">公司:</label>
<input type="text" id="company" name="company"/>
<br/>
<input type="button" onclick="save()" value="新增記錄"/>
</div>
<br/>
<div id="list"></div>
</body>
</Html>

介面呈現:

新增並寫入資料庫

// 開啟資料庫
var db = openDatabase('contactdb', '', 'local database demo', 204800);

// 儲存資料
function save() {
  var user_name = document.getElementById("user_name").value;
  var mobilephone = document.getElementById("mobilephone").value;
  var company = document.getElementById("company").value;
  // 建立時間
  var time = new Date().getTime();

  db.transaction(function (tx) {
    tx.executeSql('insert into contact values(?,?,?,?)',
      [user_name, mobilephone, company, time], onSuccess, onError);
  });
}

// SQL 執行成功後的回呼
function onSuccess(tx, rs) {
  alert("操作成功");
  loadAll();
}

// SQL 執行失敗後的回呼
function onError(tx, error) {
  alert("操作失敗,失敗資訊:" + error.message);
}

列出所有聯絡人

// 將所有存在 SQLite 資料庫中的聯絡人全部取出
function loadAll() {
  var list = document.getElementById("list");

  db.transaction(function (tx) {
    // 若資料表不存在則建立
    tx.executeSql('create table if not exists contact(name text, phone text, company text, createtime INTEGER)', []);

    // 查詢所有聯絡人記錄
    tx.executeSql('select * from contact', [], function (tx, rs) {
      if (rs.rows.length > 0) {
        var result = "<table>";
        result += "<tr><th>序號</th><th>姓名</th><th>手機</th><th>公司</th><th>新增時間</th><th>操作</th></tr>";
        for (var i = 0; i < rs.rows.length; i++) {
          var row = rs.rows.item(i);
          // 轉換時間並格式化輸出
          var time = new Date();
          time.setTime(row.createtime);
          var timeStr = time.format("yyyy-MM-dd hh:mm:ss");
          // 組裝一個表格列節點
          result += "<tr><td>" + (i + 1) + "</td><td>" + row.name
                  + "</td><td>" + row.phone + "</td><td>" + row.company
                  + "</td><td>" + timeStr
                  + "</td><td><input type='button' value='刪除' onclick='del(\""
                  + row.phone + "\")'/></td></tr>";
        }
        list.innerHTML = result + "</table>";
      } else {
        list.innerHTML = "目前資料為空,趕緊開始加入聯絡人吧";
      }
    });
  });
}

取用結果集有兩種寫法:rs.rows.item(i) 與 rs.rows[i] 都可以拿到該列;rs.rows.length 是列數,rs.rowsAffected 則是 insert/update/delete 影響的筆數。

時間格式化用的 format 方法

Date.prototype.format = function (format) {
  var o = {
    "M+" : this.getMonth() + 1,        // month
    "d+" : this.getDate(),             // day
    "h+" : this.getHours(),            // hour
    "m+" : this.getMinutes(),          // minute
    "s+" : this.getSeconds(),          // second
    "q+" : Math.floor((this.getMonth() + 3) / 3), // quarter
    "S"  : this.getMilliseconds()      // millisecond
  }
  if (/(y+)/.test(format)) format = format.replace(RegExp.$1,
    (this.getFullYear() + "").substr(4 - RegExp.$1.length));
  for (var k in o) if (new RegExp("(" + k + ")").test(format))
    format = format.replace(RegExp.$1,
      RegExp.$1.length == 1 ? o[k] : ("00" + o[k]).substr(("" + o[k]).length));
  return format;
}

刪除指定聯絡人

// 刪除聯絡人資訊
function del(phone) {
  db.transaction(function (tx) {
    // 注意這裡需明確地將傳入的參數轉為字串型別
    tx.executeSql('delete from contact where phone=?',
      [String(phone)], onSuccess, onError);
  });
}

表格樣式

th {
  font: bold 11px "Trebuchet MS", Verdana, Arial, Helvetica, sans-serif;
  color: #4f6b72;
  border-right: 1px solid #C1DAD7;
  border-bottom: 1px solid #C1DAD7;
  border-top: 1px solid #C1DAD7;
  letter-spacing: 2px;
  text-transform: uppercase;
  text-align: left;
  padding: 6px 6px 6px 12px;
}
td {
  border-right: 1px solid #C9DAD7;
  border-bottom: 1px solid #C9DAD7;
  background: #fff;
  padding: 6px 6px 6px 12px;
  color: #4f6b72;
}

最終的畫面:

幾個實務上的坑

示範程式把資料直接拼進 HTML 字串,真實專案請改用 DOM 節點建立並以 textContent 填入,否則使用者輸入的內容可能變成 XSS 攻擊的入口。另外示範的刪除欄位刻意包了雙引號(del("0912345678")),因為手機號碼若當成數字傳遞,開頭的 0 與前導零都會出問題——這也是為什麼資料表裡手機號碼該用 text 而非整數型別。

最後再強調一次:Web SQL 已停止演進, Safari 與舊版 Chrome 之外不宜依賴。要沿用這份架構的話,把 openDatabase/transaction/executeSql 換成 IndexedDB 的 indexedDB.open() 與物件倉儲操作,功能與觀念都能一一對應。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved