iPhone实战：操作SQLite

转：http://my.oschina.net/vimfung/blog/65294

SQLite是一款轻量级的数据库，是遵守ACID的关联式数据库管理系统，它的设计目标是嵌入式的，而且目前已经在很多嵌入式产品中使用了它，它占用资源非常的低，在嵌入式设备中，可能只需要几百K的内存就够了。它能够支持Windows/Linux/Unix等等主流的操作系统，同时能够跟很多程序语言相结合，比如 Tcl、C#、PHP、Java等，还有ODBC接口，当然还有我们使用的Obj-C。用这种方法保存的数据既可以在客户端存储大量数据，同时能够利用SQL语句灵活地查询、插入、更新或者删除数据。

本人在开发过程中发现关于iOS中SQLite的编程文章实在太少了，大多数都是涉及都一些简单的操作。因此，下面写到的操作我会在简单的SQLite操作基础上（其中包括打开/关闭数据库、构造表、插入、更新或者删除数据操作），再增加两项数据库操作中比较常用的功能实践，分别实现带参数SQL语句的执行以及数据库的事物启动、提交和回滚。废话不多说，直接进入主题吧。

    在iOS中使用SQLite我们需要加入libsqlite3.dylib的库，并在引入SQLite的头文件。如下：

1	#import <sqlite3.h>

    导入库和头文件之后，接下来的操作就是打开一个数据库。这时候需要调用sqlite3_open这个函数来对打开一个数据库文件。此函数声明如下：

1	int sqlite3_open(

2	const char *filename,   /* Database filename (UTF-8) */

3	sqlite3 **ppDb          /* OUT: SQLite db handle */

4

);

    其中第一个参数就是数据库所存放的路径，如果路径下没有数据库文件则系统会在此路径下创建一个数据库。至于第二个参数则是数据库的句柄引用，但此函数调用成功后此句柄将会保存打开数据库的句柄,此句柄在往后的数据库操作中需要用到。因此，可如下方式调用：

1	NSString *dbPath=[NSString stringWithFormat:@”%@/Documents/demo.db”,NSHomeDirectory()];

2	sqlite3 *dbHandle;

3	if (sqlite3_open([path UTF8String], &dbHandle)==SQLITE_OK) {

4	NSLog(@“打开数据库成功!”);

5

}

既然有打开数据库，那么就肯定有关闭数据库的操作了，我们要养成良好的习惯，当需要使用数据库的时候就执行sqlite3_open来打开数据库，等使用完数据库后就调用sqlite3_close函数来对数据库进行关闭。关于sqlite3_close函数声明如下：

1	int sqlite3_close(sqlite3 *);

关闭时传入数据库句柄即可对数据库进行关闭。调用方式如下：

1	if(sqlite3_close(dbHandle)==SQLITE_OK)

2	NSLog(@“关闭数据库成功!”);

接下来需要讲述的是如何对数据库进行操作，常用的有两种方式可以操作数据库中的数据和调整结构。

    第一种就是sqlite3_exec函数，这种方法一般使用在不返回数据集的情况，也就是说少用于查询类的操作，同时笔者也尚发现使用此函数如何配合参数使用。如果使用他来创建表结构、更新、插入或者删除操作是一种直观快捷的方法。先来看看此方法的声明：

1	int sqlite3_exec(

2	sqlite3*,                                  /* An open database */

3	const char *sql,                           /* SQL to be evaluated */

4	int (*callback)(void*,int,char**,char**),  /* Callback function */

5	void *,                                    /* 1st argument to callback */

6	char **errmsg                              /* Error msg written here */

7

);

第一个参数就是我们打开数据库的句柄了，第二个参数就是SQL语句，第三个参数为回调方法的函数指针，一旦指定此参数后，当执行语句为查询语句时则在枚举记录集时回对调此方法。第四个参数则为回调的第一个参数引用。关于第三第四个参数还有待研究（如果哪位大虾知道如何使用，不妨告诉小弟，一定感激不尽）。至于第五个参数就是如果方法执行后存在异常，那么这个参数保存的就是错误的描述信息。

    第二种就是使用sqlite3_prepare_v2和sqlite3_step两个函数搭配的进行操作。其中sqlite3_prepare_v2是一个将SQL语句编译为sqlite内部一个结构体(sqlite3_stmt).该结构体中包含了将要执行的的SQL语句的信息。而sqlite3_step则是让转化后的SQL进行下一步的操作。因此通过这两个函数可以很方便的获取到数据库中的数据。本人建议使用此方式取得记录集。下面是这两个函数的声明：

1	int sqlite3_prepare_v2(

2	sqlite3 *db,            /* Database handle */

3	const char *zSql,       /* SQL statement, UTF-8 encoded */

4	int nByte,              /* Maximum length of zSql in bytes. */

5	sqlite3_stmt **ppStmt,  /* OUT: Statement handle */

6	const char **pzTail     /* OUT: Pointer to unused portion of zSql */

7

);

    第一个参数就是打开数据库时的数据库句柄对象。第二个就是SQL语句。第三个参数是用于指定SQL语句最大的长度，如果此参数为负数，则根据第二个参数中的第一个终结符为准作为一条完整的语句。如果为非负数，则以第二个参数的第一个终结符（\000或\u0000）或者指定的数字为准作为一条完整语句。第四个参数则是调用函数后返回的一个结构体，此结构体包含了相关语句的信息。关于第五个参数是用于指向前一条语句结束位置，一旦指定此参数，则参数指向位置的左边语句将不进行编译解析。

1	sqlite3_step（sqlite3_stmt *）;

传入参数即为准备语句中的结构体对象。

       上面所说的两种方式我将会在下面举例进行说明，但是每个例子不一定两种方式都实现，如果有这方面兴趣的朋友可以自己尝试另外一种方式实现。

例子一：创建数据表

要想让数据库能够存储数据，那就必须得创建一个数据表才能进行数据操作。而数据表是可以包含不同的数据字段，这些字段可以指定不同的数据类型，存储不同的数据。我们建表时可以根据需要进行创建。下面的代码创建了一个叫做persons的数据表，其包含两个字段id和name。其SQL语句为：create table if not exists persons (id integer primary key autoincrement,name);（如果对SQL语句不太熟悉的朋友可以参考相关方面资料）。那么代码如下所示：

1	char *errorMsg;

2	if (sqlite3_exec(_database, "create table if not exists persons (id integer primary key autoincrement,name);", NULL, NULL, &errorMsg)!=SQLITE_OK) {

3	NSLog(@“操作失败!”);

4

}

5	sqlite3_free(errorMsg);

上面要注意的一点是，如果你有传入errorMsg参数，那么你必须在执行完sqlite3_exec后，执行sqlite3_free函数来释放errorMsg。否则就会造成内存泄露。

例子二：插入、更新、删除数据

上面的例子创建了一个数据后，那么我们可以往里面插入数据，我们可以使用insert语句将数据插入表中：代码如下所示：

1	char *errorMsg;

2	if (sqlite3_exec(_database, "insert into persons(name) values(‘张三’);", NULL, NULL, &errorMsg)!=SQLITE_OK) {

3	NSLog(@“操作失败!”);

4

}

5	sqlite3_free(errorMsg);

上面所做的事情就是把一个张三的数据插入了数据表persons中。上面的实现是非常方便的，但是并不安全，因为我们的SQL语句中要插入的数据是拼合到SQL语句中的，这样很容易造成注入问题，因此，我们可以使用下面的方法来实现。

01	sqlite3_stmt *statement;

02	if (sqlite3_prepare_v2(_database, [@"insert into persons(name) values(?);" UTF8String], -1, &statement, NULL)!=SQLITE_OK) {

03

return;

04

}

05

//绑定参数

06	const char *text=[@”张三” cStringUsingEncoding:NSUTF8StringEncoding];

07	sqlite3_bind_text(statement, index, text, strlen(text), SQLITE_STATIC);

08

09	if (sqlite3_step(statement)!=SQLITE_DONE) {

10	sqlite3_finalize(statement);

11

return;

12

}

13	sqlite3_finalize(statement);

推荐使用参数进行数据查询和操作，这样可以保证读写数据的正确性和提高安全性。对于更新数据和删除数据的调用方式和插入数据一样，只是SQL语句的差异，其中更新数据使用Update语法，而删除表数据则使用Delete语法。

例子三：事务处理

事务在数据库中是一个重要的概念，使用事务可以保证数据的统一和完整性。同时也可以提高效率。拿我们上面创建的persons表来说，假设我要一次插入20个人的名字才算是操作成功，那么，在不使用事务的情况下，如果插入过程中出现异常或者在插入过程中出现一些其他数据库操作的话，就很有可能影响了操作的完整性。所以事务可以很好地解决这样的情况，首先事务是可以把启动事务过程中的所有操作视为事务的过程。等到所有过程执行完毕后，我们可以根据操作是否成功来决定事务是否进行提交或者回滚。提交事务后会一次性把所有数据提交到数据库，如果回滚了事务就会放弃这次的操作，而对原来表的数据不进行更改。

那么，如何启动，提交还有回滚事务呢？SQLite中分别是：BEGIN、COMMIT和ROLLBACK。下面来看一下例子：

01

@try{

02	char *errorMsg;

03	if (sqlite3_exec(_database, "BEGIN", NULL, NULL, &errorMsg)==SQLITE_OK) {

04	NSLog(@”启动事务成功”);

05	sqlite3_free(errorMsg);

06

07	sqlite3_stmt *statement;

08	if (sqlite3_prepare_v2(_database, [@"insert into persons(name) values(?);" UTF8String], -1, &statement, NULL)==SQLITE_OK) {

09

//绑定参数

10	const char *text=[@”张三” cStringUsingEncoding:NSUTF8StringEncoding];

11	sqlite3_bind_text(statement, index, text, strlen(text), SQLITE_STATIC);

12

13	if (sqlite3_step(statement)!=SQLITE_DONE) {

14	sqlite3_finalize(statement);

15

}

16

}

17

18	if (sqlite3_exec(_database, "COMMIT", NULL, NULL, &errorMsg)==SQLITE_OK) {

19	NSLog(@”提交事务成功”);

20

}

21	sqlite3_free(errorMsg);

22

}else{

23	sqlite3_free(errorMsg);

24

}

25

}

26	@catch(NSException *e){

27	char *errorMsg;

28	if (sqlite3_exec(_database, "ROLLBACK", NULL, NULL, &errorMsg)==SQLITE_OK) {

29	NSLog(@”回滚事务成功”);

30

}

31	sqlite3_free(errorMsg);

32

}

33

@finally{

34

}

关于SQLite的操作今天就到这里告一段落，日后有相关的资料或者经验再跟大家分享。