SQLite3是嵌入在iOS中的关系型数据库，对于存储大规模的数据很有效。SQLite3使得不必将每个对象都加到内存中。这篇文章将简单介绍一下如何使用SQLite3.
注：大部分SQLite3函数返回值为SQLITE_OK为成功,否则返回SQLITE_ERROR
（1）打开数据库(若数据库文件不存在,则创建之)
SQLITE_API int sqlite3_open(
constchar*filename, /*Databasefilename(UTF-8)*/
sqlite3 **ppDb /* OUT: SQLite db handle */
);注意：数据库文件的路径必须是c语言的字符串，而非NSString传递，可以使用UTF8String将NSString转成c语言字符串。
例如：
@property (copy, nonatomic) NSString *databaseFilePath;
//获取数据库的路径
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentDictionary = [paths objectAtIndex:0];
self.databaseFilePath = [documentDictionary stringByAppendingPathComponent:kDatabaseName];
//如果数据库存在，则打开，否则创建数据库
sqlite3 *database;
int openResult = sqlite3_open([self.databaseFilePath UTF8String], &database);
if (openResult == SQLITE_OK) {
NSLog(@"database open ok!");
}
else if(openResult == SQLITE_ERROR) {
NSLog(@"database open error!");
}（2）关闭数据库
SQLITE_API int sqlite3_close(sqlite3 *);
（3）执行无返回结果集的SQL 操作(alter更改/create/delete/update)
SQLITE_API int sqlite3_exec(
sqlite3* db, /* 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 */
);
例如：
//创建数据库表
NSString *createSQL = @"CREATE TABLE IF NOT EXISTS FIELDS (TAG INTEGER PRIMARY KEY, FIELD_DATA TEXT);";
char *errorMsg;
int createResult = sqlite3_exec(database, [createSQL UTF8String], NULL, NULL, &errorMsg);（4）执行查询操作，首先需要通过下面这个函数来准备该语法：
SQLITE_API int sqlite3_prepare_v2(
sqlite3 db,
/*Database handle*/
const char *zSql, /*SQL statement,UTF-8 encoded*/
int nByte, /*Maximun length of zSql in bytes*/
sqlite3_stmt **ppStmt, /* OUT: Statement handle */
const char **pzTail /* OUT: Pointer to unused portion of zSql */
);
如果返回值，为SQLITE_OK，则说明你的语句已经准备成功，可以开始单步调试结果集，使用下面这个函数。
SQLITE_API int sqlite3_step(sqlite3_stmt*);查询过程中存取指定字段值的函数：
SQLITE_API int sqlite3_column_int(sqlite3_stmt*, int iCol);
SQLITE_API const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);
SQLITE_API int sqlite3_finalize(sqlite3_stmt *pStmt);例子：
//执行查询
NSString *query = @"SELECT TAG, FIELD_DATA FROM FIELDS ORDER BY TAG";
sqlite3_stmt *statement;
int queryResult = sqlite3_prepare_v2(database, [query UTF8String], -1, &statement, nil);
//查询准备成功
if (queryResult == SQLITE_OK) {
//依次读取数据库表格FIELDS中每行的内容，并显示在对应的TextField
while (sqlite3_step(statement) == SQLITE_ROW) {
//获得数据
int tag = sqlite3_column_int(statement, 0);
char *rowData = (char*)sqlite3_column_text(statement, 1);
//使用查询到的数据，填入文本框中
UITextField *textfield = (UITextField*)[self.view viewWithTag:tag];
textfield.text = [[NSString alloc] initWithUTF8String:rowData];
}
sqlite3_finalize(statement);
}
//关闭数据库
sqlite3_close(database);
（5）绑定变量-----可以使用绑定变量来执行数据库插入操作
要使用绑定变量插入值，只需按正常方式创建SQL语句，但是要在SQL字符串中添加一个问号，每个问号都表示一个需要在语句执行之前进行绑定的变量，然后，准备好SQL语句，将值绑定到各个变量，然后执行命令。
以下是同常使用的绑定函数。
sqlite3_bind_int(sqlite3_stmt *, int, int)
sqlite3_bind_text(sqlite3_stmt *, int, const char *, int n, void (*)(void *))
例如：//使用绑定变量插入数据
char *update = "INSERT OR REPLACE INTO FIELDS (TAG, FIELD_DATA) VALUES (?, ?);";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(database, update, -1, &stmt, nil) == SQLITE_OK) {
sqlite3_bind_int(stmt, 1, i);
sqlite3_bind_text(stmt, 2, [textField.text UTF8String], -1, NULL);
}
if (sqlite3_step(stmt)!= SQLITE_DONE) {
NSLog(@"更新数据库出错");
}
sqlite3_finalize(stmt);下面解说一下绑定函数中的参数：
第一个参数都是指向之前在sqlite3_prepare_v2调用中使用的sqlite3_stmt.
第二个参数是所绑定变量的索引，它是一个按序索引的值，SQL语句中第一个问号是索引1，而后其他的每个问号的索引值的按序增加1。
第三个参数始终表示应该替换问号的值。
通常的绑定函数就只有三个参数，但是比如说绑定文本和二进制数据的绑定函数，还有另外两个参数。
这两个参数中的第一个是在上面第三个参数中传递的数据的长度，对应c字符串来说，可以传递 -1 来代替字符串的长度。
第二个参数是可选的函数回调，用于在语句执行结束后完成一些内存的清理工作。通常，这种函数用于使用malloc（）释放已分配的内存。
注意：当使用绑定变量时，会将相同语法同时用于查询和更新，我们需要调用多次sqlite3_step，直到它返回SQLITE_DONE。
下面贴上一个完整的例子。参照http://my.oschina.net/plumsoft/blog/57626 中的例子。
这个例子比较简单，就是一个单视图。如下：
注意为四个textfield添加1 ~~ 4的tag。
大致说一下这个demo是什么功能的吧：运行时，程序会读写sandbox中的数据库对textfield进行赋值，由于首次运行时，数据库不存在，所以textfield中没有内容，而且这时会自动创建一个数据库。这时填写内容，按home键（UIApplicationWillResignActiveNotification）将应用程序推到后台，这个过程会将textfield中的数据写入数据库中。再次运行程序时，就回发现textfield中有东西了。
还有别忘了添加sqlite库文件和import。
下面就是实现的代码了：
.h文件：#import <UIKit/UIKit.h>
@interface ViewController : UIViewController
@property (copy, nonatomic) NSString *databaseFilePath;
- (void)applicationWillResignActive:(NSNotification *)notification;
@end.m文件：
#import "ViewController.h"
#import <sqlite3.h>
#define kDatabaseName @"database.sqlite3"
@interface ViewController ()
@end
@implementation ViewController
- (void)viewDidLoad
{
[super viewDidLoad];
// Do any additional setup after loading the view, typically from a nib.
//获取数据库的路径
NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
NSString *documentDictionary = [paths objectAtIndex:0];
self.databaseFilePath = [documentDictionary stringByAppendingPathComponent:kDatabaseName];
//如果数据库存在，则打开，否则创建数据库
sqlite3 *database;
int openResult = sqlite3_open([self.databaseFilePath UTF8String], &database);
if (openResult == SQLITE_OK) {
NSLog(@"database open ok!");
}
else if(openResult == SQLITE_ERROR) {
NSLog(@"database open error!");
}
//创建数据库表
NSString *createSQL = @"CREATE TABLE IF NOT EXISTS FIELDS (TAG INTEGER PRIMARY KEY, FIELD_DATA TEXT);";
char *errorMsg;
int createResult = sqlite3_exec(database, [createSQL UTF8String], NULL, NULL, &errorMsg);
if (createResult == SQLITE_ERROR) {
NSLog(@"create table error!");
//创建数据库表失败，则关闭数据库
sqlite3_close(database);
}
else if(createResult == SQLITE_OK){
//执行查询
NSString *query = @"SELECT TAG, FIELD_DATA FROM FIELDS ORDER BY TAG";
sqlite3_stmt *statement;
int queryResult = sqlite3_prepare_v2(database, [query UTF8String], -1, &statement, nil);
//查询准备成功
if (queryResult == SQLITE_OK) {
//依次读取数据库表格FIELDS中每行的内容，并显示在对应的TextField
while (sqlite3_step(statement) == SQLITE_ROW) {
//获得数据
int tag = sqlite3_column_int(statement, 0);
char *rowData = (char*)sqlite3_column_text(statement, 1);
//使用查询到的数据，填入文本框中
UITextField *textfield = (UITextField*)[self.view viewWithTag:tag];
textfield.text = [[NSString alloc] initWithUTF8String:rowData];
}
sqlite3_finalize(statement);
}
//关闭数据库
sqlite3_close(database);
}
//当程序进入后台时执行写入数据库操作
UIApplication *app = [UIApplication sharedApplication];
[[NSNotificationCenter defaultCenter] addObserver:self selector:@selector(applicationWillResignActive:) name:UIApplicationWillResignActiveNotification object:app];
}
- (void)didReceiveMemoryWarning
{
[super didReceiveMemoryWarning];
// Dispose of any resources that can be recreated.
}
- (void)applicationWillResignActive:(NSNotification *)notification{
NSLog(@"notifcation");
sqlite3 *database;
int openResult = sqlite3_open([self.databaseFilePath UTF8String], &database);
if (openResult == SQLITE_ERROR) {
NSLog(@"sqlite open error!");
}
else if(openResult == SQLITE_OK){
for (int i=1; i<=4; i++) {
//根据tag获得textfield
UITextField *textField = (UITextField*)[self.view viewWithTag:i];
//使用绑定变量插入数据
char *update = "INSERT OR REPLACE INTO FIELDS (TAG, FIELD_DATA) VALUES (?, ?);";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(database, update, -1, &stmt, nil) == SQLITE_OK) {
sqlite3_bind_int(stmt, 1, i);
sqlite3_bind_text(stmt, 2, [textField.text UTF8String], -1, NULL);
}
if (sqlite3_step(stmt)!= SQLITE_DONE) {
NSLog(@"更新数据库出错");
}
sqlite3_finalize(stmt);
}
sqlite3_close(database);
}
}
@end
大概SQLite3的简单使用就是这样了。
突然发现有一个地方值得注意的：
sqlite3_column_xxx 方法的第二个参数为纪录字段序号，从0 开始
sqlite3_bind_xxx 方法的第二个参数是指所绑定变量的索引值，也就是指问号是第几个，当然是从1开始的。
458
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
