ZPY博客

cordova调用本地SQLite数据库的方法

ZPY

一、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语句。

该方法有四个参数，其中后三个参数是可选的：

例如下面的代码，同时定义了四个参数：

tx.executeSql("INSERT INTO test_table (data, data_num) VALUES (?,?)", ["test", 100], function1，function2);

（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>