ios简单sqlite使用

使用sqlite前的准备

使用sqlite是很多做ios开发中第一次面对c的情况，包括我。因为sqlite是c写的，objc可以直接使用c代码。在sqlite前，一般都会使用cocoa touch框架，都是基于objc的。

首先，需要在对应文件的头文件中加入：

#import "/usr/include/sqlite3.h"

并在Frameworks中加入所需的库，否则会报错：

Undefined symbols:
"_sqlite3_open", referenced from:

加入库的方法是：

选择sqlite库：

选择完的效果：

然后，应该有个成员变量，比如我的代码：

@interface DetailViewController : UIViewController <UIPopoverControllerDelegate, UISplitViewControllerDelegate> {
    UIPopoverController *popoverController;
    UIToolbar *toolbar;
    id detailItem;
    UILabel *detailDescriptionLabel;
    sqlite3 *database;

打开数据库

sqlite数据库是文件数据库，是保存在文件系统中的。因此需要知道文件保存到哪里，可参见iOS中对文件的操作。比如本文保存到Documents目录下。代码：

NSArray *documentsPaths=NSSearchPathForDirectoriesInDomains(NSDocumentDirectory
                                                   , NSUserDomainMask
                                                   , YES);
NSString *databaseFilePath=[[documentsPaths objectAtIndex:0] stringByAppendingPathComponent:@"mydb"];

if (sqlite3_open([databaseFilePath UTF8String], &database)==SQLITE_OK) {
    NSLog(@"open sqlite db ok.");
}

通过ssh查看Documents目录，发现mydb文件已经创建。sqlite的策略是如果有该文件就打开，如果没有就创建文件，也就是创建数据库。

这里要注意，使用的是c语法，sqlite3_open传入的是database的地址。

关闭数据库

数据库使用完毕后，要关闭，比如退出应用的时候：

- (void)viewDidUnload {
    // Release any retained subviews of the main view.
    // e.g. self.myOutlet = nil;
   sqlite3_close(database);
    self.popoverController = nil;
}

建表语句

数据库打开以后，如果没有表，建表：

char *errorMsg;
const char *createSql="create table if not exists persons (id integer primary key autoincrement,name text)";

if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
NSLog(@"create ok.");
}

这里要特别注意errorMsg传的是地址，因为该函数要通过地址引用来写报错字符信息。

向表中插入记录

和建表语句类似：

const char *insertSql="insert into persons (name) values(‘张三’)";
    if (sqlite3_exec(database, insertSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
        NSLog(@"insert ok.");
    }

错误信息的处理

如果在多个地方使用errorMsg，那么每次使用完毕要清空一下字串，比如这样：

if (sqlite3_exec(database, createSql, NULL, NULL, &errorMsg)==SQLITE_OK) {
    NSLog(@"create ok.");
}else {
    NSLog(@"error: %s",errorMsg);
    sqlite3_free(errorMsg);
}

查询结果集

结果集的查询，需要用到statement：

const char *selectSql="select id,name from persons";
sqlite3_stmt *statement;
if (sqlite3_prepare_v2(database, selectSql, -1, &statement, nil)==SQLITE_OK) {
    NSLog(@"select ok.");
}

while (sqlite3_step(statement)==SQLITE_ROW) {
    int _id=sqlite3_column_int(statement, 0);
    char *name=(char *)sqlite3_column_text(statement, 1);
    NSLog(@"row>>id %i, name %s",_id,name);
}

sqlite3_finalize(statement);

不过这里有个问题，看看打印的日志：

乱码。因为直接用的char类型来做的。

解决办法是，用nsstring替代char：

while (sqlite3_step(statement)==SQLITE_ROW) {
    int _id=sqlite3_column_int(statement, 0);
    NSString *name=[[NSString alloc] initWithCString:(char *)sqlite3_column_text(statement, 1) encoding:NSUTF8StringEncoding];
    NSLog(@"row>>id %i, name %@",_id,name);
}

char生成nsstring的时候做一次显式的编码。问题解决：

这说明：

写入数据库，用char的方式没有问题，写入数据库的编码是对的；
从库中取出，可能默认使用ascii解码，造成显示乱码。

使用sqlite c api，要经常参考官方函数文档：http://www.sqlite.org/c3ref/funclist.html

关键函数:

sqlite3_open():打开数据库文件，如果该文件不存在，将被创建

sqlite3_close() 关闭目前打开的数据亏

sqlite3_prepare_v2():

sqlte3_step()

sqlite3_column_<type>() :返回数据field

sqlite3_finalize() 删除内存中的prepared sql语句

sqllite3_exec()

申明sqlite 数据库

sqlite3 *contactDB

打开或者创建数据库

sqlite3 *contactDB; //Declare a pointer to sqlite database structureconst char *dbpath = [databasePath UTF8String]; // Convert NSString to UTF-8if (sqlite3_open(dbpath, &contactDB) == SQLITE_OK)
{//Database opened successfully
} else {//Failed to open database

准备，执行sql语句

sqlite3_stmt *statement;NSString *querySQL = @"SELECT address, phone FROM contacts”;const char *query_stmt = [querySQL UTF8String];if (sqlite3_prepare_v2(contactDB, query_stmt, -1, &statement, NULL) == SQLITE_OK)
{//Statement prepared successfully
} else {//Statement preparation failed
}

创建表

const char *sql_stmt = "CREATE TABLE IF NOT EXISTS CONTACTS (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT, ADDRESS TEXT, PHONE TEXT)";if (sqlite3_exec(contactDB, sql_stmt, NULL, NULL, &errMsg) == SQLITE_OK)
{// SQL statement execution succeeded

从表里查询数据

sqlite3_stmt    *statement;NSString *querySQL = @"SELECT address, phone FROM contacts”;const char *query_stmt = [querySQL UTF8String];sqlite3_prepare_v2(contactDB, query_stmt, -1, &statement, NULL);

while (sqlite3_step(statement) == SQLITE_ROW)
{NSString *addressField = [[NSString alloc] initWithUTF8String:(const char *) sqlite3_column_text(statement, 0)];NSString *phoneField = [[NSString alloc] initWithUTF8String:(const char *) sqlite3_column_text(statement, 1)];// Code to do something with extracted data here[phoneField release];[addressField release];
}

删除数据：

const char *deleteSql="delete from BwWord";

sqlite3_stmt *statement;

if (sqlite3_prepare_v2(database, deleteSql, -1, &statement, nil)==SQLITE_OK) {

if(sqlite3_exec(database, deleteSql, NULL, NULL, NULL) == SQLITE_OK){

[BwAlert alertMessage:@"删除所有的数据从bwword" param:nil];

}

}else{

[BwAlert alertMessage:@"删除所有的数据失败从bwword,<< %@ >> " param: [NSString stringWithCString:sqlite3_errmsg(database) encoding:NSUTF8StringEncoding] ];

}

关闭数据库

sqlite3_close(contactDB)