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_ROW ,则说明未到结果集末尾(循环条件)。
查询过程中存取指定字段值的函数:
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开始的。