- A+
一、cordova的下载安装和建立project的方法
该部分不是文章重点,抽空另开一篇文章详细介绍。官网上有相关教程:http://cordova.apache.org/docs/en/5.0.0/guide_cli_index.md.html#The%20Command-Line%20Interface(插一句,测试时尽量用真机,虚拟机实在太慢)
二、插件下载
调用SQLite需要使用cordova的插件cordova-sqlite-storage,下载方法为在所建的project目录下打开cmd,输入cordova plugin add cordova-sqlite-storage回车。
三、插件的使用
参考资源:https://www.npmjs.com/package/cordova-sqlite-storage
使用sqlite数据库的基本步骤
(1)建立连接
有两种方法可用来创建并打开对数据库的一个连接:
var db = window.sqlitePlugin.openDatabase({name: "my.db"}); //my.db表示数据库名称 var db = window.sqlitePlugin.openDatabase("myDatabase.db", "1.0", "Demo", -1); //myDatabase.db代表数据库名称,1.0是版本号,Demo是描述信息,第四个参数参考其他资料应该是预估数据库大小,-1代表什么自己也没搞懂,请大神指点。
(2)执行SQL操作
使用db.transaction()方法来执行一个SQL操作,该方法只有一个参数。该参数是一个函数,并且通常是匿名的,可以直接定义在db.transaction()中。如:
db.transaction(function(tx){...});
这个匿名函数具有一个事务类型的参数tx,它是一个事务对象,该事物对象具有一个方法:executeSql(),使用该方法可以执行SQL语句。
该方法有四个参数,其中后三个参数是可选的:
- 查询字符串
- 替换参数化查询中的占位符的数据
- SQL执行成功时调用的回调函数
- SQL执行失败时调用的回调函数
例如下面的代码,同时定义了四个参数:
tx
(3)对结果进行处理
3.1 当SQL操作执行成功时回执行一个回调函数,即上文中的funciton1,该函数有两个参数,一个是执行他的事物对象tx,另一个是操作返回的结果res(下面会详细介绍),即:
function function1(tx,res){...}
3.2当SQL操作失败时就会调用function2,该函数也有两个参数,一个是tx,另一个是错误对象,通过该错误对象可以获知具体的错误信息:
function function2(tx,err){alert(err.message);}
3.3 成功使用executeSql()方法执行的SQL语句可以返回一个执行结果即上文中的res,该执行结果回作为回调函数的一个参数。
执行结果是一个SQLResultSet对象,由SQLResultSet接口定义:
interface SQLResultSet{
readonly attribute long insertId;
readonly attribute long rowsAffected;
readonly attribute SQLResultRowList rows;
};
1、属性insertId返回记录行的行ID,每个SQL INSERT插入操作会自动插入一个行ID,如果插入多行,则该属性返回最后一行的行ID;如果不存在记录行则调用该属性时抛出INVALID_ACCESS_ERR异常。
2、属性rowsAffect返回SQL语句所改变的记录行的行数,如果没有任何改变,则该属性返回0;
3、属性rows 返回一个SQLResultList 对象,表示返回的所用记录行,结果按照数据库中的序列排列,如果没有数据,则返回空对象,即SQLResultList.length属相值为0;
SQLResultList对象由SQLResultList 接口定义:
interface SQLResultSetRowList{
readonly attribute unsigned long length;
getter any item(in unsigned long index);
};
1、属性length表示返回记录行的总行数。
2、item(x)方法根据索引号x获取一个指定的行(下标从0开始)。如果不存在指定的索引号,则该方法返回null。
一行就是一个javascript Object类型的对象,每个记录行的属性名相当于对象的属性名,例如row={id:0,data:“test”,data_num:100},使用对象语法可以获取每个属性的值,如row["data"](记得加引号)。
整体代码如下:
在手机上显示结果为:
data_num=100
data=test
id=0
<!DOCTYPE HTML> <html> <head> <meta charset="utf-8"> <script src="cordova.js" type="text/javascript"></script> <link rel="stylesheet" href="http://code.jquery.com/ui/1.11.0/themes/smoothness/jquery-ui.css"> <script src="http://code.jquery.com/jquery-1.10.2.js"></script> <script src="http://code.jquery.com/ui/1.11.0/jquery-ui.js"></script> <link rel="stylesheet" href="http://jqueryui.com/resources/demos/style.css"> <link rel="stylesheet" href="http://code.jquery.com/mobile/1.3.2/jquery.mobile-1.3.2.min.css"> <script src="http://code.jquery.com/mobile/1.3.2/jquery.mobile-1.3.2.min.js"></script> </head> <body> <script> document.addEventListener("deviceready", onDeviceReady, false); function onDeviceReady() { var db = window.sqlitePlugin.openDatabase("Database", "1.0", "Demo", -1); db.transaction(function(tx) { tx.executeSql('DROP TABLE IF EXISTS test_table'); tx.executeSql('CREATE TABLE IF NOT EXISTS test_table (id integer primary key, data text, data_num integer)'); tx.executeSql("INSERT INTO test_table (data, data_num) VALUES (?,?)", ["test", 100], function(tx, res) { tx.executeSql("select * from test_table", [], function(tx, res) { alert("hello world"); var row=res.rows.item(0); for(var j in row){ document.write(j+"="+row[j]+"<br />"); } }); }, function(e) { alert("ERROR: " + e.message); }); }); } </script> </body> </html>