PhoneGap学习笔记(五) 本地数据库WEB SQL、localStorage和sessionStorage

WEB SQL允许我们在客户端创建小型数据库。它本身是一个Sqlite嵌入式数据库

一、打开或创建一个数据库

var db = window.openDatabase("testDB","1.0","testDB",100000,function(){});

该方法打开一个数据库，如果数据库不存在则创建一个数据并返回数据库示例，接收5个参数

第一个:数据库名称

第二个：版本

第三个：数据库显示名称或描述

第四个：数据库大小

第五个：创建回调(该参数非必须)

二、事务

db.transaction(function(tx){},function(error){},function(){});

开始事务包含三个参数，其中第一个参数为必须参数，第二、三个参数为非必须。

第一个参数：必须，执行事务的方法，自动传入事务对象

第二个参数：事务执行失败的回调

第三个参数：事务执行成功的回调

通过事务的executeSql(sql,args,function(tx,resultSet){},function(tx,error){})执行SQL语句，该方法包含四个参数，其中第一个参数为必须，后面三个位非必须

第一个参数:需要执行的sql语句

第二个参数:sql语句中的占位符?的执行参数(如果sql语句中包含了“?”占位符，则该参数为必须参数，多个参数使用数组一一对应)

第三个参数:执行成功回调，该回调传回两个参数，第一个为事务对象，第二个为结果集(如果有返回结果集的查询，参数必须)

第四个参数:执行错误回调

三、关于executeSql中的成功回调函数

executeSql执行成功后的回调函数会传入两个参数tx和resultSet,其中tx是事务对象，resultSet则包含三个属性，分别是insertId,rowsAffected,rows，执行不同SQL语句，这三个属性值也不相同。

insertId:这是执行INSERT语句时插入行的ID。其余情况尝试读取该属性会有异常抛出：

Uncaught InvalidAccessError: Failed to read the 'insertId' property from 'SQLResultSet': The query didn't result in any rows being added.

rowsAffected:被SQL语句影响的行的个数，如果没有任何改变返回0

rows：查询是返回的结果集，该属性为一个对象，包含两个属性，length和item,遍历如下(假设结果集中包含一列名叫name)

for(var i=0,len=rows.length;i<len;i++){

   var name=rows.item(i).name

}

四，关于id自增长、主键和数据类型

设置一列为主键并自增长：“id INTEGER PRIMARY KEY AUTOINCREMENT”

如：CREATE TABLE IF NOT EXISTS tUser(id INTEGER PRIMARY KEY AUTOINCREMENT,name VARCHAR)

SQLite字段无数据类型，定义列时可忽略数据类型，无论定义成INTEGER、VARCHAR还是TEXT，它们的保存方式都是字符串，但有个特殊情况，即设置某一列为自增长时，必须

指定该列数据类型为INTEGER，其它情况依然建议写上合适的数据类型，虽然无效但是便于同其它程序员交流。

完整示例：

<div id="msg"></div>

var msg=document.getElementById("msg");
init();
function init(){ 
  var db = window.openDatabase("testDB","1.0","testDB",100000);//打开数据库
  initDB(db);
  insertData(db);
  updateData(db);
  findDate(db);
  
}
//创建数据表
function initDB(db){
    db.transaction(function(tx){
        var sql="CREATE TABLE IF NOT EXISTS tUser(id INTEGER PRIMARY KEY AUTOINCREMENT,name VARCHAR)";
        tx.executeSql(sql,[],function(){},function(tx,err){console.log(tx);console.log(err);});
    });    
}
//插入数据
function insertData(db){
    db.transaction(function(tx){
        tx.executeSql("INSERT INTO tUser(name) VALUES(?);",['小米'],function(){},function(tx,err){console.log(err);});
        tx.executeSql("INSERT INTO tUser(name) VALUES(?);",['小明'],function(tx,resultSet){console.log(resultSet);});
    },function(errormsg){
        console.log(errormsg);    
    });
}
//修改数据
function updateData(db){
    db.transaction(function(tx){
        tx.executeSql("UPDATE tUser SET name=? WHERE id=?",['小明2',2]);
    });
}
//查询数据
function findDate(db){
   db.transaction(function(tx){
           var sql="SELECT * FROM tUser";
           //var sql="SELECT * FROM tUser LIMIT 0,3"//同mysql一致的limit查询，limit第二个参数传入-1表示查询到记录末尾
        tx.executeSql(sql,[],function(tx,resultSet){
            var rows = resultSet.rows;
            var str="";
            for(var i=0,len=rows.length;i<len;i++){
                  str=str+rows.item(i).id+":"+rows.item(i).name+"<br/>"
            }
            msg.innerHTML=str;
        });
   });     
}

结果：

localStorage和sessionStorage的方法一样，唯一不同的是localStorage的数据可以持久存储而sessionStorage的数据在关闭浏览器后会被清除

保存数据的方式有三种，这三种方式的结果都是一致的

var localStorage=window.localStorage;
localStorage.setItem("key1","value1");
localStorage.key2="value2";
localStorage["key3"]="value3";

读取方式也有三种，无论用哪种方式保存，都可以用以下三种方式之一读取

localStorage.getItem("key1");
localStorage.key1;
localStorage["key1"];

localStorage.key(i):返回第i处的key，如果没有返回null

localStorage.removeItem("key1");移除key对应的键值对

localStorage.clear();清除所有键值对

localStorage.length;获取localStorage键值对的数量

本文地址：http://www.cnblogs.com/wangjiajun/p/4054323.html