上一篇文章我们学习了简单的sql语句iOS-数据库-SQL语句,这篇就学习一下在iOS中如何使用SQLite3进行增删改查。
一. SQLite的增删改查
1. 创建数据库
在iOS中使用SQLite3,首先要添加库文件libsqlite3.dylib和导入主头文件#import <sqlite3.h>导入库文件和头文件之后就可以使用库中的函数(是纯C语言的)。
xib创建如下界面:打开数据库函数介绍:
sqlite3_open(<#const char *filename#>, <#sqlite3 **ppDb#>)
作用:把一个文件名称传递给他,它会自动检测这个文件是否存在,如果不存在的话,会自动创建相应的文件(这里为数据库文件,刚创建为空)。
参数:它的第一个参数为文件的名称(需转换为C语言的),第二个参数是数据库的实例,sqlite3 *db;
说明:sqlite3是一种类型,db是数据库的句柄,就是数据库的象征,如果要进行增删改查,就得操作db这个实例。
返回值:它的返回值为int型的,根据函数的返回值可以知道,打开数据库文件是成功还是失败,如果返回值是SQLITE_OK则说明成功,否则为失败。
在ViewController里写如下代码:
@property (nonatomic,assign) sqlite3 *db;
- (void)viewDidLoad {
[super viewDidLoad];
//db是数据库句柄,就是数据库的象征,要对数据库进行增删改查就要操作这个实例
sqlite3 *db;
//获取数据库文件的路径
NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *filePath = [doc stringByAppendingPathComponent:@"students.sqlite"];
NSLog(@"%@",filePath);
//Users/xujincheng/Library/Developer/CoreSimulator/Devices/A3BD602E-4365-4B04-9FA4-61186DCE8ADA/data/Containers/Data/Application/6DCB697A-08D1-4C2E-AB13-E64523057459/Documents/students.sqlite
//将OC字符串转成C语言的字符串
const char *cfilePath = filePath.UTF8String;
//打开数据库文件, 如果数据库文件不存在,这个函数就会自动创建数据库文件
int result = sqlite3_open(cfilePath, &db);
if (result == SQLITE_OK) {
NSLog(@"打开成功");
} else {
NSLog(@"打开失败");
}
}
创建数据库也可以使用版本v2的方法,其中SQLITE_OPEN_FULLMUTEX是数据库安全的,如下:
int status = sqlite3_open_v2(cfilePath, &db, SQLITE_OPEN_CREATE | SQLITE_OPEN_FULLMUTEX | SQLITE_OPEN_READWRITE, NULL);
if (status != SQLITE_OK) {
NSLog(@"sqlite3_open_v2 fail");
}
运行之后,数据库打开成功。
2019-11-06 14:16:14.233774+0800 增删改查[95678:8083587] /Users/xujincheng/Library/Developer/CoreSimulator/Devices/A3BD602E-4365-4B04-9FA4-61186DCE8ADA/data/Containers/Data/Application/6DCB697A-08D1-4C2E-AB13-E64523057459/Documents/students.sqlite
2019-11-06 14:16:14.234588+0800 增删改查[95678:8083587] 打开成功
拷贝路径,进去沙盒,发现数据库文件的确存在2. 创建表
执行sql语句函数:
sqlite3_exec(<#sqlite3 *#>, <#const char sql#>, <#int (callback)(void *, int, char **, char **)#>, <#void *#>, <#char **errmsg#>)
参数:第一个参数为数据库的句柄(db),第二个参数为sql语句,第三个参数为回调参数,是一个指向函数的指针,如果把callback前面的*改成^则就是一个block代码段,第四个参数可以写NULL,第五个参数为错误信息,用以代码调试。
在ViewController再写如下代码:
const char *sql="CREATE TABLE IF NOT EXISTS t_students (id integer PRIMARY KEY AUTOINCREMENT,name text NOT NULL,age integer NOT NULL);";
char *errmsg=NULL;
result = sqlite3_exec(db, sql, NULL, NULL, &errmsg);
if (result==SQLITE_OK) {
NSLog(@"创表成功");
} else {
NSLog(@"创表失败");
}
self.db = db;
运行后,结果如下创建表除了可以用sqlite3_exec,也可以用如下方法:
- (void)createTable{
//1. 语句
NSString *sqlStr = @"create table if not exists t_student(id char, name char)";
sqlite3_stmt *stmt;
//2. 检查语句
int status = sqlite3_prepare_v2(database, [sqlStr UTF8String], -1, &stmt, 0);
if (status != SQLITE_OK) {
NSLog(@"sqlite3_prepare_v2 fail");
sqlite3_finalize(stmt);
return;
}
//3. 执行指令
status = sqlite3_step(stmt);
if (status != SQLITE_DONE) {
NSLog(@"sqlite3_step fail");
}
//4. 结束
sqlite3_finalize(stmt);
}
3. 增删改查
1. 插入数据
代码如下:
//增
- (IBAction)insert:(UIButton *)sender {
for (int i=0; i<20; i++) {
//1.拼接SQL语句
NSString *name=[NSString stringWithFormat:@"文晓--%d",arc4random_uniform(100)];
int age=arc4random_uniform(20)+10;
NSString *sql=[NSString stringWithFormat:@"INSERT INTO t_students (name,age) VALUES ('%@',%d);",name,age];
//2.执行SQL语句
char *errmsg=NULL;
sqlite3_exec(self.db, sql.UTF8String, NULL, NULL, &errmsg);
if (errmsg) {//如果有错误信息
NSLog(@"插入数据失败--%s",errmsg);
} else {
NSLog(@"插入数据成功");
}
}
}
或者也可以不使用sqlite3_exec函数, 如下
- (void)insertSQLValue:(NSString*)idStr name:(NSString*)name{
NSString *sqlStr = [NSString stringWithFormat:@"insert into eoctable values('%@', '%@')", idStr, name];
sqlite3_stmt *stmt;
int status = sqlite3_prepare_v2(database, [sqlStr UTF8String], -1, &stmt, 0);
if (status != SQLITE_OK) {
NSLog(@"sqlite3_prepare_v2 fail");
sqlite3_finalize(stmt);
return;
}
status = sqlite3_step(stmt);
if (status != SQLITE_DONE) {
NSLog(@"sqlite3_step fail");
}
sqlite3_finalize(stmt);
}
点击插入按钮,结果如下
2019-11-06 15:21:29.761000+0800 增删改查[96517:8150075] 插入数据成功
2019-11-06 15:21:29.762393+0800 增删改查[96517:8150075] 插入数据成功
2019-11-06 15:21:29.763576+0800 增删改查[96517:8150075] 插入数据成功
2019-11-06 15:21:29.765049+0800 增删改查[96517:8150075] 插入数据成功
打开students.sqlite文件,如下图(这里我刷新了好几次甚至重启Navicat才有数据)
2. 删除数据
待补充
3. 修改数据
待补充
4. 查找数据
函数说明:
select操作也可以使用sqlite3_exec函数实现,但通常使用下面的函数。
sqlite3_prepare_v2(<#sqlite3 *db#>, <#const char *zSql#>, <#int nByte#>, <#sqlite3_stmt **ppStmt#>, <#const char **pzTail#>)
参数:第一个参数为数据库的句柄,第二个参数为sql语句,第三个参数为sql的长度(如果设置为-1,则代表系统会自动计算sql语句的长度),第四个参数用来取数据,第五个参数为尾部一般用不上可直接写NULL。
//查
- (IBAction)select:(UIButton *)sender {
const char *sql="SELECT id,name,age FROM t_students WHERE age<20;";
sqlite3_stmt *stmt=NULL;
//进行查询前的准备工作
if (sqlite3_prepare_v2(self.db, sql, -1, &stmt, NULL)==SQLITE_OK) {//SQL语句没有问题
NSLog(@"查询语句没有问题");
//每调用一次sqlite3_step函数,stmt就会指向下一条记录
while (sqlite3_step(stmt)==SQLITE_ROW) {//找到一条记录
//取出数据
//(1)取出第0列字段的值(int类型的值)
int ID = sqlite3_column_int(stmt, 0);
//(2)取出第1列字段的值(text类型的值)
const unsigned char *name = sqlite3_column_text(stmt, 1);
//(3)取出第2列字段的值(int类型的值)
int age = sqlite3_column_int(stmt, 2);
// NSLog(@"%d %s %d",ID,name,age);
printf("%d %s %d\n",ID,name,age);
}
} else {
NSLog(@"查询语句有问题");
}
sqlite3_finalize(stmt);
}
代码解析:
sqlite3_step() 执行sql语句, 返回SQLITE_ROW代表遍历到一条新记录
sqlite3_column_*()用于获取每个字段对应的值,第2个参数是字段的索引,从0开始
查询结果如下:
2019-11-06 15:29:39.329693+0800 增删改查[96669:8159730] 查询语句没有问题
2 文晓--92 14
4 文晓--58 16
9 文晓--49 17
17 文晓--45 16
26 文晓--45 16
27 文晓--34 11
28 文晓--37 18
29 文晓--98 18
31 文晓--89 19
33 文晓--57 18
34 文晓--65 10
37 文晓--9 17
38 文晓--5 18
39 文晓--13 10
40 文晓--24 12
二. SQLite常用函数
- 打开数据库
int sqlite3_open(
const char *filename, // 数据库的文件路径
sqlite3 **ppDb // 数据库实例
);
- 关闭数据库
int sqlite3_close_v2(sqlite3*); //传入数据库句柄
- 执行任何SQL语句
sqlite3_exec()可以执行任何SQL语句,比如创表、更新、插入和删除操作。但是一般不用它执行查询语句,因为它只会返回执行语句是成功还是失败, 不会返回查询到的数据
int sqlite3_exec(
sqlite3, // 一个打开的数据库实例
const char sql, // 需要执行的SQL语句
int (callback)(void,int,char**,char**), // SQL语句执行完毕后的回调
void *, // 回调函数的第1个参数
char **errmsg // 错误信息
);
sqlite3_exec() 还可以执行的语句:
(1)开启事务:begin transaction;
(2)回滚事务:rollback;
(3)提交事务:commit;
- 检查SQL语句的合法性(查询前的准备)
int sqlite3_prepare_v2(
sqlite3 *db, // 数据库实例
const char *zSql, // 需要检查的SQL语句
int nByte, // SQL语句的最大字节长度
sqlite3_stmt **ppStmt, // sqlite3_stmt实例,可以理解为一条指令,用来获得数据库数据
const char **pzTail
);
- 查询一行数据
int sqlite3_step(sqlite3_stmt*); // 如果查询到一行数据,就会返回SQLITE_ROW ,可以理解为执行指令
- 利用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); // 字符串数据
- sql语句准备: sqlite3_prepare_v2
SQLITE_API int sqlite3_prepare_v2(
sqlite3 db, / Database handle */
const char zSql, / SQL statement, UTF-8 encoded /
int nByte, / Maximum length of zSql in bytes. */
sqlite3_stmt *ppStmt, / OUT: Statement handle */
const char *pzTail / OUT: Pointer to unused portion of zSql */
);
代码解析:
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 *对象
Demo地址:数据库操作