一组支持PhoneGap的数据库工具类

我所做的一个项目中用到了 PhoneGap的数据库.在PhoneGap中遇到问题,是很纠结的.但是我发现一些简单的方法， 因此我写了一组支持工具类来支持我的项目. 我把它分享给大家.

 我的工具类库有如下特性s:

executeBatch:得到文件路径 (通过 URL), 你可以通过 PhoneGap 读取包括SQL设置命令的XML文件. 示例:

1. myDbController.executeBatch("sql/createtables.xml",successHandler,errHandler);

复制代码

这里的XML如下:

1. <sql>
2. <statement>
3. create table foo if not exists foo(....)
4. </statement>
5. <statement>
6. create table moo if not exists foo(....)
7. </statement>
8. </sql>

复制代码

和 Adobe AIR的机制不一样,  SQLite在PhoneGap中 不允许你预填充数据库. (虽然有折中的方法: Prepopulate SQLite DataBase in PhoneGap Application.) 这是通过修改 Christope Coenraets得到的语法。 

executeSql: 真如你所预料的,这只是结束执行的SQL. PhoneGap没有使这点很困难 , 我发现 API 所有的回调都要使用. ("All"  例如:

1. dbController.executeSql("select * from notes", gotNote, errHandler);

复制代码

 

另一个好处是这里会自动获取结果然后返回简单的array对象. 其次, 大大简化了过程. 

最后, 这个类有一个简单的 init() handler. 它也可以自动调用您的批处理脚本。例如:

1. dbController.init("main","data/seed.xml",dbReady);

复制代码

代码如下：

1. var DBController = function() {
3.     var db,success,failure;
4.     
5.     return {
7.         init:function(name,importscript,successHandler)    {
8.             //todo - allow for version
9.             db = window.openDatabase(name,"1.0",name,100000);            
10.             if(typeof importscript !== "undefined") {
11.                 console.log("being asked to run a script");
12.                 if(typeof successHandler === "undefined") throw "Invalid call - must pass success handler when importing data";
13.                 this.executeBatch(importscript,successHandler);
14.             }
15.         },
17.         executeBatch:function(path,successHandler,errorHandler) {
18.             success=successHandler;
19.             failure=errorHandler;
20.             
21.             $.get(path, {}, this.gotFile, "xml");
22.         },
24.         //sql, successHandler, errorHandler are required
25.         executeSql:function(sql,args,successHandler,errorHandler) {
26.             console.log('going to run '+sql+ ' '+arguments.length);
27.             //Don't like this - but way to make args be optional and in 2nd place
28.             if(arguments.length == 3) {
29.                 successHandler = arguments[1];
30.                 errorHandler = arguments[2];
31.                 args = [];
32.             }
33.             db.transaction(
34.                 function(tx) { tx.executeSql(sql,args,function(tx,res) {
35.                     //todo - figure out fraking scoping rules and why line below didnt work, nor this.X
36.                     //res = translateResultSet(res);
37.                     var result = [];
38.                     for(var i=0; i<res.rows.length; i++) {
39.                         result.push(res.rows.item(i));
40.                     }
41.                     successHandler(result);
42.                 })}
43.             , errorHandler)    
44.         },
45.         
46.             
47.         gotFile:function(doc) {
48.             var statements = [];
49.             var statementNodes=doc.getElementsByTagName("statement");
50.             for(var i=0; i<statementNodes.length; i++) {
51.                 statements.push(statementNodes[i].textContent);
52.             }
53.             if(statements.length) {
54.                 db.transaction(function(tx) {
55.                     //do nothing
56.                     for(var i=0;i<statements.length;i++) {
57.                         tx.executeSql(statements[i]);
58.                     }
59.                 }, failure,success);
60.             }
61.         },
62.         
63.         translateResultSet:function(res) {
64.             var result = [];
65.             for(var i=0; i<res.rows.length; i++) {
66.                 result.push(res.rows.item(i));
67.             }
68.             return result;
69.             
70.         }
71.             
72.     }
73.     
74. };

复制代码