iOS数据持久化(4)－SQLite

学习SQLite不是本文的目的，所以关于SQLite的学习，请查找其他资料，本文的重点是iOS上使用SQLite入门

1.介绍

什么是SQLite

SQLite是一种嵌入式的关系型数据库，大多数关系型服务器都是运行于一个独立的服务器，但是SQLite却无需独立服务器，而是以C语言库的形式存在，并且代码量非常的小。所以集成的成本非常的低。
还有另外一个好处，SQLite是开源并且免费的～

关于SQL

SQL是Structured Query Language（结构化请求语句）的意思，大多数关系型数据库，都是用SQL语言操作数据库。

2.SQL代码讲解

假设你的电脑里已经安装了SQLite，尤其是Mac，是预装的。

打开/创建数据库文件

ns:Desktop Realank$ sqlite3 ./mydatabase.sqlite
SQLite version 3.8.10.2 2015-05-20 18:17:19
Enter ".help" for usage hints.
sqlite>

打开数据库以后，需要创建一个数据表(table)，用来表格化存储数据。

创建表的时候，需要指定表包含的元素，和各个元素的类型：

sqlite> CREATE TABLE CONTACTS (ID INTEGER PRIMARY KEY AUTOINCREMENT, NAME TEXT, ADDRESS TEXT, PHONE TEXT);

然后就是熟悉的增删改查

增加一行数据：

INSERT INTO CONTACTS (NAME, ADDRESS, PHONE) VALUES ("zhang","Nanjing Road","18612345678");

删除一行数据：

DELETE FROM CONTACTS WHERE NAME = "wang";

修改一行数据：

UPDATE CONTACTS SET NAME = "wang" WHERE NAME = "zhang";

查询语句：

SELECT * FROM CONTACTS;

3.iOS使用SQLite语句

导入sqlite3库

iOS可以导入苹果提供好的sqlite3库，在项目设置中添加即可

然后在项目中导入头文件：

#import <sqlite3.h>

选择存放数据库文件的位置

我们决定将文件存储在沙盒的Cache目录下
什么是沙盒，以及怎么打开沙盒，请看这里
我们生成数据库文件的路径

NSString *cachePath = [NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES) firstObject];
NSString *databasePath = [cachePath stringByAppendingPathComponent:@"contacts.sqlite"];

打开数据库

如果数据库文件不存在，则创建文件

    sqlite3 *contactDB; //Declare a pointer to sqlite database structure
    const char *dbpath = [databasePath UTF8String]; // Convert NSString to UTF-8
    //打开数据库文件，没有则创建
    if (sqlite3_open(dbpath, &contactDB) == SQLITE_OK) {
        NSLog(@"数据库打开成功");
    } else {
        NSLog(@"数据库打开失败");
    }

创建数据表

    char sql_stmt[1000];
    //创建表
    snprintf(sql_stmt, sizeof(sql_stmt)/sizeof(char),"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, NULL) == SQLITE_OK)
    {
        NSLog(@"成功创建表");
    }

增删改查

    sqlite3_stmt *statement;
    
    //－－－增－－－
    snprintf(sql_stmt, sizeof(sql_stmt)/sizeof(char), "INSERT INTO CONTACTS (NAME, ADDRESS, PHONE) VALUES (\"zhang\",\"Nanjing Road\",\"18612345678\")");
    if (sqlite3_exec(contactDB, sql_stmt, NULL, NULL, NULL) == SQLITE_OK)
    {
        NSLog(@"成功增加一行");
    }
    
    //－－－删－－－
    snprintf(sql_stmt, sizeof(sql_stmt)/sizeof(char), "DELETE FROM CONTACTS WHERE NAME = \"wang\"");
    if (sqlite3_exec(contactDB, sql_stmt, NULL, NULL, NULL) == SQLITE_OK)
    {
        NSLog(@"成功删除一行");
    }
    
    
    //－－－改－－－
    snprintf(sql_stmt, sizeof(sql_stmt)/sizeof(char), "UPDATE CONTACTS SET NAME = \"wang\" WHERE NAME = \"zhang\"");
    if (sqlite3_exec(contactDB, sql_stmt, NULL, NULL, NULL) == SQLITE_OK)
    {
        NSLog(@"成功修改一行");
    }
    
    //－－－查－－－
    snprintf(sql_stmt, sizeof(sql_stmt)/sizeof(char), "SELECT id, NAME, ADDRESS FROM CONTACTS");
    //准备一个SQL语句，用于执行
    sqlite3_prepare_v2(contactDB, sql_stmt, -1, &statement, NULL);
    
    //执行一条准备的语句,如果找到一行匹配的数据，则返回SQLITE_ROW
    while (sqlite3_step(statement) == SQLITE_ROW) {
        //获取执行的结果中，某一列的数据，并指定获取的类型（int, text...）,如果内部类型和获取的类型不一致，方法内部将会对内容进行类型转换
        NSInteger index = sqlite3_column_int(statement, 0);
        NSString *nameField = [[NSString alloc] initWithUTF8String: (const char *) sqlite3_column_text(statement, 1)];
        NSString *addressField = [[NSString alloc] initWithUTF8String: (const char *) sqlite3_column_text(statement, 2)];
        NSLog(@"%ld %@ %@",(long)index,nameField,addressField);
    }
    sqlite3_finalize(statement);//在内存中，清除之前准备的语句

关闭数据库

    sqlite3_close(contactDB);//关闭数据库

4.iOS sqlite3库主要API讲解

1. sqlite3_open() － 打开对应的数据库文件，如果文件不存在，则创建
2. sqlite3_close() － 关闭之前打开的数据库
3. sqlite3_prepare_v2() － 准备一条SQL语句，用于执行（SQL语句需要先准备，之后再step执行）
4. sqlite3_step() － 执行一条准备好的语句
5. sqlite3_column_<type>() － 获取执行的结果中，某一列的数据，并指定获取的类型（int, text...）,如果内部类型和获取的类型不一致，方法内部将会对内容进行类型转换
6. sqlite3_finalize() － 从内存中删除之前准备好的语句，每一条准备好的语句，都需要删除，否则会资源泄漏
7. sqlite3_exec() － 集成了sqlite3_prepare_v2(), sqlite3_step(), sqlite3_finalize()到一条语句

5. GitHub

整个数据持久化操作的Demo代码，都存储在GitHub中

其中SQLite操作的内容，在RACSQLiteDemo类中