iOS 数据存储 - SQLite3

纯C语言，占用资源非常的低，处理速度快，用于处理大批量数据的存储

数据库存储数据的步骤?
1）新建一张表（table）
2）添加多个字段（column，列，属性）
3）添加多行记录（row，record，每行存放多个字段对应的值）

一、使用步骤

1.首先要添加库文件libsqlite3.tbd和导入主头文件#import

2.打开数据库

（1）创建数据库的句柄db

sqlite3 *database;

（2）获得数据库文件的路径

    NSString *document  = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES)lastObject];
    NSString *path      = [document stringByAppendingPathComponent:@"students.sqlite"];

（3）将oc字符串转换为c语言字符串，打开数据库文件（不存在，则自动创建该文件）

sqlite3_open([path UTF8String], &database);

（4） 准备sql statement和sql语句

sqlite3_stmt *stmt;
const char *sql = "SELECT * FROM table_name WHERE pk=? and name=?";
sqlite3_prepare_v2(database, sql, -1, &stmt, NULL);

（5） 使用约束变量,绑定参数

// 绑定第一个int参数
sqlite3_bind_int(stmt, 1, 1);
// 绑定第二个字符串参数
sqlite3_bind_text(stmt, 2, [title UTF8String], -1, SQLITE_TRANSIENT);

（6） 执行sql statement

sqlite3_step(stmt);

（7）释放sql statement资源

sqlite3_finalize(stmt);

（8） 关闭iPhone上的sqlite3的数据库

sqlite3_close(database);

3.创建表

sqlite3_exec(db, sql, NULL, NULL, &errmsg);

4.插入数据/删除数据/更新数据

sqlite3_exec(db, sql, NULL, NULL, &errmsg);

5.查询数据

sqlite3_prepare_v2(self.db, sql, -1, &stmt, NULL)

二、基本属性

1.打开数据库

int sqlite3_open(
const char *filename,   // 数据库的文件路径
sqlite3 **ppDb          // 数据库实例
);

2.执行任何SQL语句

int sqlite3_exec(
sqlite3*,                                  // 一个打开的数据库实例
const char *sql,                           // 需要执行的SQL语句
int (*callback)(void*,int,char**,char**),  // SQL语句执行完毕后的回调
void *,                                    // 回调函数的第1个参数
char **errmsg                              // 错误信息
);

3.检查SQL语句的合法性（查询前的准备）

int sqlite3_prepare_v2(
sqlite3 *db,            // 数据库实例
const char *zSql,       // 需要检查的SQL语句
int nByte,              // SQL语句的最大字节长度
sqlite3_stmt **ppStmt,  // sqlite3_stmt实例，用来获得数据库数据
const char **pzTail
);

4.查询一行数据

int sqlite3_step(sqlite3_stmt*); // 如果查询到一行数据，就会返回SQLITE_ROW

5.利用stmt获得某一字段的值（字段的下标从0开始）

double sqlite3_column_double(sqlite3_stmt*, int iCol);  // 浮点数据
int sqlite3_column_int(sqlite3_stmt*, int iCol); // 整型数据
sqlite3_int64 sqlite3_column_int64(sqlite3_stmt*, int iCol); // 长整型数据
const void *sqlite3_column_blob(sqlite3_stmt*, int iCol); // 二进制文本数据
const unsigned char *sqlite3_column_text(sqlite3_stmt*, int iCol);  // 字符串数据

6.创建、打开、关闭数据库
创建或打开数据库

// path是数据库文件的存放路径
sqlite3 *db = NULL;
int result = sqlite3_open([path UTF8String], &db); 

代码解析：
sqlite3_open()将根据文件路径打开数据库，如果不存在，则会创建一个新的数据库。如果result等于常量SQLITE_OK，则表示成功打开数据库
sqlite3 *db：一个打开的数据库实例
数据库文件的路径必须以C字符串(而非NSString)传入

关闭数据库
sqlite3_close(db);

7.执行不返回数据的SQL语句
执行创表语句

char *errorMsg = NULL;  // 用来存储错误信息
char *sql = "create table if not exists t_person(id integer primary key autoincrement, name text, age integer);";
int result = sqlite3_exec(db, sql, NULL, NULL, &errorMsg);

代码解析：
sqlite3_exec()可以执行任何SQL语句，比如创表、更新、插入和删除操作。但是一般不用它执行查询语句，因为它不会返回查询到的数据
sqlite3_exec()还可以执行的语句：
（1）开启事务：begin transaction;
（2）回滚事务：rollback;
（3）提交事务：commit;

8.带占位符插入数据

char *sql = "insert into t_person(name, age) values(?, ?);";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
sqlite3_bind_text(stmt, 1, "母鸡", -1, NULL);
    sqlite3_bind_int(stmt, 2, 27);
}
if (sqlite3_step(stmt) != SQLITE_DONE) {
NSLog(@"插入数据错误");
}
sqlite3_finalize(stmt);

代码解析：
sqlite3_prepare_v2()返回值等于SQLITE_OK，说明SQL语句已经准备成功，没有语法问题
sqlite3_bind_text()：大部分绑定函数都只有3个参数
（1）第1个参数是sqlite3_stmt *类型
（2）第2个参数指占位符的位置，第一个占位符的位置是1，不是0
（3）第3个参数指占位符要绑定的值
（4）第4个参数指在第3个参数中所传递数据的长度，对于C字符串，可以传递-1代替字符串的长度
（5）第5个参数是一个可选的函数回调，一般用于在语句执行后完成内存清理工作
sqlite_step()：执行SQL语句，返回SQLITE_DONE代表成功执行完毕
sqlite_finalize()：销毁sqlite3_stmt *对象

9.查询数据

char *sql = "select id,name,age from t_person;";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
while (sqlite3_step(stmt) == SQLITE_ROW) {
    int _id = sqlite3_column_int(stmt, 0);
    char *_name = (char *)sqlite3_column_text(stmt, 1);
    NSString *name = [NSString stringWithUTF8String:_name];
    int _age = sqlite3_column_int(stmt, 2);
    NSLog(@"id=%i, name=%@, age=%i", _id, name, _age);
}
}
sqlite3_finalize(stmt);

代码解析：
sqlite3_step()返回SQLITE_ROW代表遍历到一条新记录
sqlite3_column_*()用于获取每个字段对应的值，第2个参数是字段的索引，从0开始

三、代码示例
1.SQLite增删改查示例
https://github.com/shileseal/SLSqlite3Demo

四、总结