iPhone实战：操做SQLite

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

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

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

 

#import <sqlite3.h>

 

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

 

int sqlite3_open(
  const char *filename,   /* Database filename (UTF-8) */
  sqlite3 **ppDb          /* OUT: SQLite db handle */
);

 

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

 

NSString *dbPath=[NSString stringWithFormat:@”%@/Documents/demo.db”,NSHomeDirectory()];
sqlite3 *dbHandle;
if (sqlite3_open([path UTF8String], &dbHandle)==SQLITE_OK) {
	NSLog(@“打开数据库成功!”);
}

 

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

 

int sqlite3_close(sqlite3 *);

 

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

 

if(sqlite3_close(dbHandle)==SQLITE_OK)
	NSLog(@“关闭数据库成功!”);

 

接下来须要讲述的是如何对数据库进行操做，经常使用的有两种方式能够操做数据库中的数据和调整结构。

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

 

int sqlite3_exec(
  sqlite3*,                                  /* An open database */
  const char *sql,                           /* SQL to be evaluated */
  int (*callback)(void*,int,char**,char**),  /* Callback function */
  void *,                                    /* 1st argument to callback */
  char **errmsg                              /* Error msg written here */
);

 

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

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

 

int sqlite3_prepare_v2(
  sqlite3 *db,            /* Database handle */
  const char *zSql,       /* SQL statement, UTF-8 encoded */
  int nByte,              /* Maximum length of zSql in bytes. */
  sqlite3_stmt **ppStmt,  /* OUT: Statement handle */
  const char **pzTail     /* OUT: Pointer to unused portion of zSql */
);

 

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

 

sqlite3_step（sqlite3_stmt *）;

 

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

       上面所说的两种方式我将会在下面举例进行说明，可是每一个例子不必定两种方式都实现，若是有这方面兴趣的朋友能够本身尝试另一种方式实现。

例子一：建立数据表

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

 

char *errorMsg;
if (sqlite3_exec(_database, "create table if not exists persons (id integer primary key autoincrement,name);", NULL, NULL, &errorMsg)!=SQLITE_OK) {
     NSLog(@“操做失败!”);
}
sqlite3_free(errorMsg);

 

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

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

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

 

char *errorMsg;
if (sqlite3_exec(_database, "insert into persons(name) values(‘张三’);", NULL, NULL, &errorMsg)!=SQLITE_OK) {
    NSLog(@“操做失败!”);
}
sqlite3_free(errorMsg);

 

上面所作的事情就是把一个张三的数据插入了数据表persons中。上面的实现是很是方便的，可是并不安全，由于咱们的SQL语句中要插入的数据是拼合到SQL语句中的，这样很容易形成注入问题，所以，咱们可使用下面的方法来实现。

 

sqlite3_stmt *statement;
if (sqlite3_prepare_v2(_database, [@"insert into persons(name) values(?);" UTF8String], -1, &statement, NULL)!=SQLITE_OK) {
    return;
}
//绑定参数
const char *text=[@”张三” cStringUsingEncoding:NSUTF8StringEncoding];
sqlite3_bind_text(statement, index, text, strlen(text), SQLITE_STATIC);

if (sqlite3_step(statement)!=SQLITE_DONE) {
    sqlite3_finalize(statement);
    return;
}
sqlite3_finalize(statement);

 

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

例子三：事务处理

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

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

 

@try{
		char *errorMsg;
		if (sqlite3_exec(_database, "BEGIN", NULL, NULL, &errorMsg)==SQLITE_OK) {
			NSLog(@”启动事务成功”);
			sqlite3_free(errorMsg);

		sqlite3_stmt *statement;
			if (sqlite3_prepare_v2(_database, [@"insert into persons(name) values(?);" UTF8String], -1, &statement, NULL)==SQLITE_OK) {
				//绑定参数
				const char *text=[@”张三” cStringUsingEncoding:NSUTF8StringEncoding];
				sqlite3_bind_text(statement, index, text, strlen(text), SQLITE_STATIC);

				if (sqlite3_step(statement)!=SQLITE_DONE) {
					sqlite3_finalize(statement);
				}
			}

			if (sqlite3_exec(_database, "COMMIT", NULL, NULL, &errorMsg)==SQLITE_OK) {
				NSLog(@”提交事务成功”);
			}
			sqlite3_free(errorMsg);
		}else{
			sqlite3_free(errorMsg);
		}
	}
	@catch(NSException *e){
		char *errorMsg;
		if (sqlite3_exec(_database, "ROLLBACK", NULL, NULL, &errorMsg)==SQLITE_OK) {
			NSLog(@”回滚事务成功”);
		}
		sqlite3_free(errorMsg);
	}
	@finally{
	}

 

关于SQLite的操做今天就到这里告一段落，往后有相关的资料或者经验再跟你们分享。