SQLite简介
sqlite是一款轻量级的数据库,sqlite的第一个版本是2000年就发布了的,经过十多年的历练,显然sqlite目前已经相当成熟。sqlite最大的特点就是没有任何数据库服务器,无论是C、java、node.js,只需要相应的驱动,就可以直接对数据库进行读写,速度是相当的快。相比之下,其他的sql数据库必须启动一个服务,而且还要安装、配置,sqlite简洁的令人感动。
Node.js安装sqlite3模块
和其他语言一样,node.js仍然只需要一个module就可以对sqlite进行操作了。
npm find sqlite
发现sqlite的模块居然有几十个,足见node.js目前的火爆程度,小小的sqlite就有这么多可用模块。
其中一个就叫做sqlite3,解释如下:
sqlite3 Asynchronous, non-blocking SQLite3 bindings 异步,非阻塞sqlite3绑定。
node.js最大的特点就是异步,这款sqlite的驱动太符合node的核心思想了,经过与其他模块的比较,最终还是选择了这款。
npm install sqlite3
就将sqlite的驱动安装进来了。
调用SQLite3的接口
1. var sqlite3 = require('sqlite3');
2. var db = new sqlite3.Database('/tmp/1.db',function() {
3. db.run("create table test(name varchar(15))",function(){
4. db.run("insert into test values('hello,world')",function(){
5. db.all("select * from test",function(err,res){
6. if(!err)
7. console.log(JSON.stringify(res));
8. else
9. console.log(err);
10. });
11. })
12. });
13. });
执行:
node test.js
[{"name":"hello,world"}]
插入的时候使用db.run(),查询的时候使用db.all()
由于是异步,必须在执行sql后注册回调函数,这样如果连续执行几十条sql,那代码就跟楼梯差不多了。但这就是node的特点,所以还是要慢慢适应。
引入SQLite3模块
1. var fs = require('fs');
2. var file = 'test.db';//这里写的就是数据库文件的路径
3. var exists = fs.existsSync(file);
4. var sqlite3 = require('sqlite3').verbose();
5. var db = new sqlite3.Database(file);
增删改查操作
1. //增
2. var sql1 = db.prepare("insert into 表名 values (内容,跟mysql一样)");
3. sql1.run();
4. //删
5. var sql2 = db.prepare("delete from 表名 where id = 1");
6. sql2.run();
7. //改
8. var sql3 = db.prepare("update 表名 set name = winston where id = 1");
9. sql3.run();
10. //查
11. //查一个表的所有数据
12. db.all("select * from 表名",function(err,row){
13. console.log(JSON.stringify(row));
14. })
15. //查一条数据
16. db().each("select * from 表名",function(err,row){
17. console.log(row);
18. })
SQLite3 API介绍
在nodejs的模块安装模块下,进入sqlite3/lib目录下,打开sqlite3.js文件查看,操作数据库主要是用Database,Database相关的函数有:run、prepare、each、get、all、exec、map和close。
Database
• 用法:new sqlite3.Database(filename,[mode],[callback])。
• 功能:返回数据库对象并且自动打开和连接数据库,它没有独立打开数据库的方法。
close
• 用法:close([callback])。
• 功能:关闭和释放数据库对象。
run
• 用法:run(sql,param,...],[callback])。
• 功能:运行指定参数的SQL语句,完成之后调用回调函数,它不返回任何数据,在回调函数里面有一个参数,SQL语句执行成功,则参数的值为null,反之为一个错误的对象,它返回的是数据库的操作对象。在这个回调函数里面当中的this,里面包含有lastId(插入的ID)和change(操作影响的行数,如果执行SQL语句失败,则change的值永远为0)。
get
• 用法:get(sql,[param,...],[callback])。
• 功能:运行指定参数的SQL语句,完成过后调用回调函数。如果执行成功,则回调函数中的第一个参数为null,第二个参数为结果集中的第一行数据,反之则回调函数中只有一个参数,只参数为一个错误的对象。
all
• 用法:all(sql,[param,...],[callback])。
• 功能:运行指定参数的SQL语句,完成过后调用回调函数。如果执行成功,则回调函数中的第一个参数为null,第二个参数为查询的结果集,反之,则只有一个参数,且参数的值为一个错误的对象。
prepare
• 用法:prepare(sql,[param,...],[callback])。
• 功能:预执行绑定指定参数的SQL语句,返回一个Statement对象,如果执行成功,则回调函数的第一个参数为null,反之为一个错误的对象。
具体事例
由于sqlite3 API具体使用过程中重复代码量较多,所以进行了简单封装,在使用过程中如果第一次创建数据库和表,紧接着插入数据的话,可能导致表还未创建完成就查询出现错误(Nodejs是基于异步的且顺序不可控),所以在表创建和插入数据时使用同步方式操作来保证表已经存在。封装的代码如下:
1. var fs = require('fs');
2. var sqlite3 = require('sqlite3').verbose();
3.
4. var DB = DB || {};
5.
6. DB.SqliteDB = function(file){
7. DB.db = new sqlite3.Database(file);
8.
9. DB.exist = fs.existsSync(file);
10. if(!DB.exist){
11. console.log("Creating db file!");
12. fs.openSync(file, 'w');
13. };
14. };
15.
16. DB.printErrorInfo = function(err){
17. console.log("Error Message:" + err.message + " ErrorNumber:" + errno);
18. };
19.
20. DB.SqliteDB.prototype.createTable = function(sql){
21. DB.db.serialize(function(){
22. DB.db.run(sql, function(err){
23. if(null != err){
24. DB.printErrorInfo(err);
25. return;
26. }
27. });
28. });
29. };
30.
31. /// tilesData format; [[level, column, row, content], [level, column, row, content]]
32. DB.SqliteDB.prototype.insertData = function(sql, objects){
33. DB.db.serialize(function(){
34. var stmt = DB.db.prepare(sql);
35. for(var i = 0; i < objects.length; ++i){
36. stmt.run(objects[i]);
37. }
38.
39. stmt.finalize();
40. });
41. };
42.
43. DB.SqliteDB.prototype.queryData = function(sql, callback){
44. DB.db.all(sql, function(err, rows){
45. if(null != err){
46. DB.printErrorInfo(err);
47. return;
48. }
49.
50. /// deal query data.
51. if(callback){
52. callback(rows);
53. }
54. });
55. };
56.
57. DB.SqliteDB.prototype.executeSql = function(sql){
58. DB.db.run(sql, function(err){
59. if(null != err){
60. DB.printErrorInfo(err);
61. }
62. });
63. };
64.
65. DB.SqliteDB.prototype.close = function(){
66. DB.db.close();
67. };
68.
69. /// export SqliteDB.
70. exports.SqliteDB = DB.SqliteDB;
针对以上封装接口的调用代码如下:
1. /// Import SqliteDB.
2. var SqliteDB = require('./sqlite.js').SqliteDB;
3. var file = "Gis1.db";
4. var sqliteDB = new SqliteDB(file);
5.
6. /// create table.
7. var createTileTableSql = "create table if not exists tiles(level INTEGER, column INTEGER, row INTEGER, content BLOB);";
8. var createLabelTableSql = "create table if not exists labels(level INTEGER, longitude REAL, latitude REAL, content BLOB);";
9. sqliteDB.createTable(createTileTableSql);
10. sqliteDB.createTable(createLabelTableSql);
11.
12. /// insert data.
13. var tileData = [[1, 10, 10], [1, 11, 11], [1, 10, 9], [1, 11, 9]];
14. var insertTileSql = "insert into tiles(level, column, row) values(?, ?, ?)";
15. sqliteDB.insertData(insertTileSql, tileData);
16.
17. /// query data.
18. var querySql = 'select * from tiles where level = 1 and column >= 10 and column <= 11 and row >= 10 and row <=11';
19. sqliteDB.queryData(querySql, dataDeal);
20.
21. /// update data.
22. var updateSql = 'update tiles set level = 2 where level = 1 and column = 10 and row = 10';
23. sqliteDB.executeSql(updateSql);
24.
25. /// query data after update.
26. querySql = "select * from tiles where level = 2";
27. sqliteDB.queryData(querySql, dataDeal);
28. sqliteDB.close();
29.
30. function dataDeal(objects){
31. for(var i = 0; i < objects.length; ++i){
32. console.log(objects[i]);
33. }
34. }