iOS 常用 SQLite 数据库存储数据,工程中需要引入 sqlite3
库。SQLite 提供 C 接口以供调用。
1、打开数据库
调用 sqlite3_open()
方法,参数为数据库文件路径(NSString *filePath)和一个 sqlite3*
类型的变量(sqlite3 *_db),如果数据库文件不存在,该函数会自动创建数据库文件。该函数只能接收 const char * 类型的路径参数,所以 NSString 需要转换类型,调用 NSString 的实例方法 [filePath UTF8String]; 即:
sqlite3_open([filePath UTF8String], &_db);
函数返回 int 类型的值,苹果定义了一系列返回值,其中 SQLITE_OK
代表打开成功,否则失败。若失败则调用关闭数据库方法 sqlite3_close(_db)
;
2、创建表 TABLE
语句格式为 CREATE TABLE IF NOT EXISTS
表的名字 (字段1名 字段 1类型, 字段 2名 字段 2类型, 字段 3名,字段 3类型)
例如:创建表名为 student,字段名为 name,age,sign 的表(TABLE),语句为
NSString *sql = @"CREATE TABLE IF NOT EXISTS student (name TEXT, age INTEGER, sign TEXT)";
调用函数 sqlite3_exec(_db, [sql UTF8String], NULL, NULL, &error)
; 同样该函数返回 int,SQLITE_OK 表示创建 TABLE 成功。
3、插入数据
语句:
NSString *sql = @"INSERT OR REPLACE INTO student (name, age, sign) VALUES (?, ?, ?)";
表示插入 name, age, sign,三个字段,三个问号(?, ?, ?)是字段值的占位符。
第①步:预处理
定义语句对象 sqlite3_stmt *statement
;
执行 sqlite3_prepare_v2(_db, [sql UTF8String], -1, &statement, NULL)
;返回 SQLITE_OK 表示预处理成功。
第②步:绑定
调用以下函数,将字段值绑定。其中第二哥参数为 int 类型,表示字段在 sql 语句 中索引,且索引从 1 开始。注意不是字段在数据库中的实际索引。
sqlite3_bind_text
(statement, 1, [name UTF8String], -1, NULL);
sqlite3_bind_int(statement, 2, (int)age);
sqlite3_bind_text(statement, 3, [sign UTF8String], -1, NULL);
返回 SQLITE_OK 表示绑定成功
第③步:执行插入
调用 sqlite3_step(statement);返回 SQLITE_DONE 表示插入完成,否则是失败。执行后调用 sqlite3_finalize(statement) 释放资源。
4、查询数据
语句 : NSString *sql = @"SELECT * FROM student WHERE age = ? and name = ?"
;
之后的步骤 预处理、绑定与插入数据一致。绑定之后执行 :
sqlite3_step(statement)
;返回 SQLITE_ROW
,表示查到数据,sqlite3_step(statement) 函数可循环执行,执行一次查询到一条数据,知道返回结果不是 SQLITE_ROW,表示没有查到数据了,则不再执行。
查到数据之后提取数据,根据不同字段的不同数据类型调用 sqlite3_column_int()
, sqlite3_column_text
等方法获取数据,返回值即为字段的值。如:
sqlite3_column_int(statement, 1);表示提取索引为 1 的字段的值,且该值为 INTEGER 类型;需要注意这里的索引为字段在数据库中的实际索引,且索引从 0 开始。
如果字段值类型为 TEXT,则返回值类型为 const unsigned char *, 需要转为 NSString。例如:
char *dbSign = (char *)sqlite3_column_text(statement, 2);
NSString *sign = [[NSString alloc] initWithUTF8String:dbSign];
若查询 Table 中的所有数据,则执行语句
NSString *sql = @"SELECT * FROM student";
步骤为预处理和执行,这里没有“绑定”这一步骤,因为sql语句没有参数(所以绑定应该是指绑定参数)
5、删除数据
1)删除 Table 中的所有记录
语句:NSString *sql = [NSString stringWithFormat:@"DELETE FROM %@", kStudentTableName];
与查询所有数据步骤一致,先预处理,后执行,没有绑定
2)根据字段的值删除记录
语句:DELETE FROM student WHERE name = ?
6、修改数据
1)修改 Table 中的所有记录
UPDATE student SET sign = ?
2)修改符合条件的记录
UPDATE student SET sign = ? WHERE age = ?
字段名后面必须是 = ?,后面再把字段的值绑定过去,而不是直接把值写到 sqlite 语句中。