首页 > 代码库 > PhoneGap学习笔记(五) 本地数据库WEB SQL

PhoneGap学习笔记(五) 本地数据库WEB SQL

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,其它情况依然建议写上合适的数据类型,虽然无效但是便于同其它程序员交流。

 

完整示例:

1 <div id="msg"></div>
 1 var msg=document.getElementById("msg"); 2 init(); 3 function init(){  4   var db = window.openDatabase("testDB","1.0","testDB",100000);//打开数据库 5   initDB(db); 6   insertData(db); 7   updateData(db); 8   findDate(db); 9   10 }11 //创建数据表12 function initDB(db){13     db.transaction(function(tx){14         var sql="CREATE TABLE IF NOT EXISTS tUser(id INTEGER PRIMARY KEY AUTOINCREMENT,name VARCHAR)";15         tx.executeSql(sql,[],function(){},function(tx,err){console.log(tx);console.log(err);});16     });    17 }18 //插入数据19 function insertData(db){20     db.transaction(function(tx){21         tx.executeSql("INSERT INTO tUser(name) VALUES(?);",[‘小米‘],function(){},function(tx,err){console.log(err);});22         tx.executeSql("INSERT INTO tUser(name) VALUES(?);",[‘小明‘],function(tx,resultSet){console.log(resultSet);});23     },function(errormsg){24         console.log(errormsg);    25     });26 }27 //修改数据28 function updateData(db){29     db.transaction(function(tx){30         tx.executeSql("UPDATE tUser SET name=? WHERE id=?",[‘小明2‘,2]);31     });32 }33 //查询数据34 function findDate(db){35    db.transaction(function(tx){
var sql="SELECT * FROM tUser";
//var sql="SELECT * FROM tUser LIMIT 0,3"//同mysql一致的limit查询,limit第二个参数传入-1表示查询到记录末尾
36 tx.executeSql(sql,[],function(tx,resultSet){37 var rows = resultSet.rows;38 var str="";39 for(var i=0,len=rows.length;i<len;i++){40 str=str+rows.item(i).id+":"+rows.item(i).name+"<br/>"41 }42 msg.innerHTML=str;43 });44 }); 45 }

结果:

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

PhoneGap学习笔记(五) 本地数据库WEB SQL