iOS数据存储之SqLite3

iOS中数据存储的方式有很多中,当数据量较大的时候偏好设置,归档和plist就无法满足需求了

这时候就需要用SqLite或者CoreData来存储数据

下面就来介绍一下如何使用SqLite存储数据

要使用Sqlite必须引入libSqlite3.dylib库

要使用首先要有一个handle句柄(handle句柄，在C语言中，通常把用于控制某类东西的叫做句柄，实际上是一个指针。)

// 数据库句柄
    sqlite3 *_db;

SqLite存储数据时也是存在一个文件中的,只不过这个文件格式是定制的,可以让SqLite快速查询到其需要的数据

所以如果要使用SqLite数据库首先要创建一个数据库文件,所以要有一个文件路径

// 一个NSString分类
- (NSString *)appendDocumentDir
{
    NSString *docDir = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)[0];

    return [docDir stringByAppendingPathComponent:self];
}

    // 设置沙盒中的文件路径
    // 提示：在自己开发中，不要用.db结尾的sqlite数据库文件名
    NSString *dbPath = [@"readme.db" appendDocumentDir];
    NSLog(@"%@", dbPath);

上面创建了我们存储数据库文件的路径dbPath

下面我们就开始创建这个存储文件

/**
     sqlite3_open
     
     1) 如果数据库存在，直接打开
     2) 如果数据库不存在，先创建数据库文件，再打开
     */
    _db = NULL;
    
    if (SQLITE_OK == sqlite3_open([dbPath UTF8String], &_db)) {
        NSLog(@"数据库打开成功");
    } else {
        NSLog(@"数据库打开失败");
    }

调用sqlite3_open函数就会创建或者打开一个数据库,如果指定路径已经存在数据库就会打开这个数据库,如果指定的dbPath不存在数据库就会创建一个数据库然后打开,创建或者打开的时候一是要传入路径,二是要传入句柄,因为后面的数据库增删改查都要靠句柄来干活.

上面代码中的SQLITE_OK是SqLite操作结果的返回码,具体含义可以参照头文件或者帮助文档

此时我们就有了一个可以操作的数据库了,有了数据库以后第一件事肯定是建一张表

#pragma mark 创建数据表
- (void)createTable
{
    // 避免重复建表的思路
    // 1. 检查沙盒，判断数据库文件是否存在，如果存在就不再建表；
    // 2. 数据库的方法：IF NOT EXISTS，放在表名之前即可
    // 定义SQL语句
    NSString *sql = @"CREATE TABLE IF NOT EXISTS T_Person (id INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT, name TEXT, gender INTEGER, age INTEGER, height REAL)";

    [self execSQL:sql message:@"创建数据表"];
}

#pragma mark 单步执行SQL
- (void)execSQL:(NSString *)sql message:(NSString *)message
{
    // 执行SQL语句
    /**
     1> 数据库句柄
     2> 要执行的SQL语句
     3> 回调：SQL指令执行完成后，调用的函数，就叫做回调函数
     4> 回调函数的第一个参数
     5> SQL语句执行的出错信息
     */
    char *errmsg = NULL;
    if (SQLITE_OK == sqlite3_exec(_db, [sql UTF8String], NULL, NULL, &errmsg)) {
        NSLog(@"%@成功!", message);
    } else {
        // C语言中字符串输出应该用%s
        NSLog(@"%@失败 - %s", message, errmsg);
    }
}

第一个方法是创建好建表语句,然后交给第二个我方法去执行建表操作

关于建表语句:CREATE TABLE IF NOT EXISTS没有这张表时才创建,如果有问题会及时发现

　　　　　　　表名称一般以T_开头,防止与关键字或者类名变量名冲突

sqlite3_exec函数可以执行SQL语句,从而对数据库进行操作

第一个参数是操作数据库用的句柄,第二个参数是执行的sql语句,第三四个参数是回调相关的参数,最后一个是错误信息

如果打印出成功信息建表就成功了.

然后增删改功能照着上面的代码写好SQL语句,直接调用就可以了,下面看看查询时该怎么写代码

- (void)allPersons
{
    // 1. SQL
    NSString *sql = @"SELECT id, name, age, gender, height FROM T_Person";
    
    // 2. 查询语句通常是使用字符串拼接出来的
    // 因此，在正常使用查询语句之前，需要检查SQL语句的语法正确！
    sqlite3_stmt *stmt = NULL;
    
    if (SQLITE_OK == sqlite3_prepare_v2(_db, [sql UTF8String], -1, &stmt, NULL)) {
        NSLog(@"语法正确");
        // 利用句柄，逐一查询符合条件的数据
        // sqlite3_step 每次提取一条查询的记录行，不断重复，一直取到最后一条记录位置
        while (SQLITE_ROW == sqlite3_step(stmt)) {
            // 取到行信息，逐一获取每一列的内容
            // iCol对应的就是SQL语句中字段的顺序，从0开始
            // 根据实际查询字段的属性，使用sqlite3_column_xxx取得对应的内容即可
            int ID = sqlite3_column_int(stmt, 0);
            const unsigned char *name = sqlite3_column_text(stmt, 1);
            int age = sqlite3_column_int(stmt, 2);
            int gender = sqlite3_column_int(stmt, 3);
            CGFloat height = sqlite3_column_double(stmt, 4);
            
            // const unsigned char *直接输出看不出结果，需要转换
            NSString *nameUTF8 = [NSString stringWithUTF8String:(const char *)name];
            
            Person *p = [Person personWithID:ID name:nameUTF8 age:age gender:gender height:height];
            
            NSLog(@"%@", p);
        }
    } else {
        NSLog(@"语法错误");
    }
}

查询的时候基本步骤就是:1.创建查询语句

　　　　　　　　　　　2.创建sqlite3_stmt结果集

　　　　　　　　　　　3.用sqlite3_prepare_v2函数建立结果集和操作句柄之间的关系,并且检查语法

　　　　　　　　　　　4.while (SQLITE_ROW == sqlite3_step(stmt)) 循环判断并且从中取出数据

　　　　　　　　　　　5.sqlite3_column_int(stmt, 0);用类似函数取出数据,第二个参数是所在

其他关于数据库主键,外键和其他约束的请查阅sqlite资料

另外有一个SQLite的第三方类库FMDB,有兴趣的可以去github上搜一下　　　　　

x