首页 > 代码库 > (转)phonegap 数据库详解
(转)phonegap 数据库详解
原文:http://firepix.iteye.com/blog/1618343
phonegap 数据库详解 博客分类:
- web App
今天就把之前使用phonegap的一些见解和疑惑写出来,以便于自己以后查看,有兴趣的同学也可以那去查看,可以做一些参考,本人也是刚学习,所以其中有引起分歧的部分,可以直接的进行斧正,也可邮箱我:zygmain@gmail.com(or:935517644QQ)
1,openDatabase
phonegap官方文档中已经很清楚的标明,如果使用一个数据库首先要用window对象进行创建:
var dbShell = window.openDatabase(name, version, display_name, size);
参数:
- name:标明数据库的名称
- version:版本号
- display_name:显示名称,与name的区别在于数据库表中,分别有这两个字段。
- size:数据库的大小
详解:
之前,在利用工厂模式,创建了一个数据库对象:
function db(name,ver,dis,size){
.......
var _db = window.openDatabase(name,ver,dis,size);
_db.transaction();
}
调用function方法进行创建db对象时,new db(),里面传入的参数可以是需要的四个参数,但是,我用下面这个方法的时候就遇到了一个问题,先看方法:
var newdb = {
_db:‘‘,
db:function(){
if(!newdb._db){
newdb._db = window.openDatabase("database","1.0","mydatabase",10000);
return new db(newdb._db);
}
}
}
疑惑:在进行调用工厂类创建数据库的时候,传入的参数竟然可以不是给定的四个参数,而是直接的传入了一个数据库对象;并且当获取到从工厂类中生成的数据库对象,其中也存在一个_db,两个数据库,究竟在执行transaction事务的时候调用的是哪一个?
上面说了这么多,都是为了铺陈:
其中的过程是这样的:
//首先程序会为当前应用在data文件夹下创建一个以当前应用包名的文件夹
//当运行window.openDatabase方法后,会在该文件夹下创建一个app_database文件夹;里面创建一个Database.db数据库文件,会在这个数据库文件中创建两个表:Database和Origins;Database存放在创建数据库时,填写的参数信息,Origins中存放数据库文件夹路径
图1:Database数据库中的两个表
图2:Databases表
Databases表中创建的数据库文件夹路径(origin字段)和文件路径(path字段),默认第一次创建是在file__0/ 0000000000000001.db.这个才是我们真正创建的数据库文件。你调用数据库对象进行数据库操作都是在这个数据库下进行的。
当我们指定的数据库不存在时会帮我们新建一个数据库,当存在了只会返回一个已有的数据库对象。
2,SQLTransaction对象
该对象是用来操作executesql方法;
执行transaction方法,在接受一个SQLTransaction对象的同时,它还会执行其中的回调函数:
db.transaction(populateDB, errorCB, successCB);
当你调用Database对象的transaction方法后,其回调函数将被调用并接收一个SQLTransaction对象。用户可以通过SQLTransaction对象多次调用executeSql来建立一个数据库事务处理。
function populateDB(tx) { tx.executeSql(‘DROP TABLE DEMO IF EXISTS‘); tx.executeSql(‘CREATE TABLE IF NOT EXISTS DEMO (id unique, data)‘); tx.executeSql(‘INSERT INTO DEMO (id, data) VALUES (1, "First row")‘); tx.executeSql(‘INSERT INTO DEMO (id, data) VALUES (2, "Second row")‘); } function errorCB(err) { alert("Error processing SQL: "+err); } function successCB() { alert("success!"); } var db = window.openDatabase("Database", "1.0", "PhoneGap Demo", 200000); db.transaction(populateDB, errorCB, successCB);
3,SQLResultSet对象
执行executesql方法,返回对象:SQLResultSet,对象中的属性
- insertId:SQLResultSet对象通过SQL语句插入到数据库的行记录的行ID。[译注:如果插入多行的时候,返回最后一个行的ID]
- rowAffected:被SQL语句改变的记录行数,如果语句没有影响任何行则设置为0。
- rows:是一个SQLResultSetRowList对象,表示返回的多条记录。如果没有返回任何记录,则此对象为空。
SQLResultSet对象可以在执行executesql的成功回调函数中获取到:
参考文档中的例子:tx.executeSql(‘SELECT * FROM DEMO‘, [], querySuccess, errorCB);
第一个参数为要执行的数据库语句。与普通操纵数据库语句没太大区别。
第二个参数为一个数组对象,存放sql语句中需要的参数的数组,就是sql语句里面出现的?所需要的参数。
第三个参数为执行成功后,调用的方法,在这个函数中可以获取到结果集results.是一个sqlresultset对象
第四个参数为执行错误时候调用的方法。
接下来我们看一下querySuccess这个回调方法。
function querySuccess(tx, results) {
// 因为没有插入记录,所以返回值为空
console.log("Insert ID = " + results.insertId);
// 因为这是一条查询语句所以返回值为0
console.log("Rows Affected = " + results.rowAffected);
// 返回查询到的记录行数量
console.log("Insert ID = " + results.rows.length);
}
4,SQLResultSetList对象
包含SQL查询所返回的所有行数据。
属性:
- length: SQL查询所返回的记录行数。
方法:
- item:根据指定索引返回一个行记录的JavaScript对象。
总结:
db.transaction(SQLTransaction,err,sucss);
SQLResultSet = SQLTransaction.executesql("select * from",[],succ,err);
SQLResultSetList = SQLResultSet.rows;
item = SQLResultSetList.item(i);