iOS数据持久化—SQLite的应用

iOS开发数据库篇—SQLite的应用

一、简单说明

　　在iOS中使用SQLite3，首先要添加库文件libsqlite3.dylib和导入主头文件。

　　

导入头文件，可以使用库中的函数（是纯C语言的）

 

二、具体说明

新建一个项目，在项目的主界面中放四个按钮（分别是，增加、删除、修改、查询）。

1.sqlite3_open(<#const char *filename#>, <#sqlite3 **ppDb#>)函数的一些说明：

（1）作用：把一个文件名称传递给他，它会自动检测这个文件是否存在，如果不存在的话，会自动创建相应的文件（这里为数据库文件，刚创建为空）。

（2）参数：它的第一个参数为文件的名称（需转换为C语言的），第二个参数是数据库的实例，sqlite3 *db；

　　说明：sqlite3是一种类型，db是数据库的句柄，就是数据库的象征，如果要进行增删改查，就得操作db这个实例。

（3）返回值：它的返回值为int型的，根据函数的返回值可以知道，打开数据库文件是成功还是失败，如果返回值是SQLITE_OK则说明成功，否则为失败。

2.打开数据库

　　实现代码和显示：

查看沙盒内创建的数据库文件：

　　

双击打开，查看发现打开的数据库连接名称为students,默认为文件名的前缀，数据库创建成功。

　　

3.创建表

　　函数说明：

　　

　　参数：第一个参数为数据库的句柄（db），第二个参数为sql语句，第三个参数为回调参数，是一个指向函数的指针，如果把callback前面的*改成^则就是一个block代码段，第四个参数可以写NULL，第五个参数为错误信息，用以代码调试。

//1.打开数据库文件（如果数据库文件不存在，那么该函数会自动创建数据库文件）
    int result = sqlite3_open(cfileName, &db);
    if (result==SQLITE_OK) {        //打开成功
        NSLog(@"成功打开数据库");
        
    //2.创建表
        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(@"创表失败----%s",errmsg);
        }
    }else
    {
        NSLog(@"打开数据库失败");
    }

 

　　执行后，创表成功，打开创建的表查看：

调试技巧：

if (result==SQLITE_OK) {
            NSLog(@"创表成功");
        }else
        {
//            NSLog(@"创表失败----%s",errmsg);
            printf("创表失败---%s----%s---%d",errmsg,__FILE__,__LINE__);
        }

 

　　__FILE__宏打印文件名，

　　__LINE__宏打印行号。

　　

4.插入数据

　　实现代码：

- (IBAction)insert {
    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(@"插入数据成功");
        }
    }
}

 

　　打印查看：

查看数据库里t_students表中的数据：

 

5.选择（select）查询操作

　　函数说明：

　　select操作也可以使用sqlite3_exec函数实现，但通常使用下面的函数。

　　

　　参数：第一个参数为数据库的句柄，第二个参数为sql语句，第三个参数为sql的长度（如果设置为-1，则代表系统会自动计算sql语句的长度），第四个参数用来取数据，第五个参数为尾部一般用不上可直接写NULL。

　　示例代码：

- (IBAction)select {
    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(@"查询语句有问题");
    }
    
}

 

　　打印查看查询结果：

三、补充

　　完整代码：

　　 YYViewController.m文件

//
//  YYViewController.m
//  02-SQLite的应用
//

#import "YYViewController.h"
#import <sqlite3.h>

@interface YYViewController ()
  //db是数据库的句柄，就是数据库的象征，要对数据库进行增删改查，就得操作这个实例
@property(nonatomic,assign)sqlite3 *db;
- (IBAction)insert;
- (IBAction)delete;
- (IBAction)update;
- (IBAction)select;

@end

@implementation YYViewController

- (void)viewDidLoad
{
    [super viewDidLoad];
    
//    sqlite3 *db;
    
    //获得数据库文件的路径
    NSString *doc=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    NSString *fileName=[doc stringByAppendingPathComponent:@"students.sqlite"];
    //将OC字符串转换为c语言的字符串
    const char *cfileName=fileName.UTF8String;
    
    //1.打开数据库文件（如果数据库文件不存在，那么该函数会自动创建数据库文件）
    int result = sqlite3_open(cfileName, &_db);
    if (result==SQLITE_OK) {        //打开成功
        NSLog(@"成功打开数据库");
        
    //2.创建表
        const char  *sql="CREATE TABLE  t_students (id integer PRIMARY KEY AUTOINCREMENT,name text NOT NULL,age integer NOT NULL);";
        char *errmsg=NULL;
        result = sqlite3_exec(self.db, sql, NULL, NULL, &errmsg);
        if (result==SQLITE_OK) {
            NSLog(@"创表成功");
        }else
        {
//            NSLog(@"创表失败----%s",errmsg);
            printf("创表失败---%s----%s---%d",errmsg,__FILE__,__LINE__);
        }
    }else
    {
        NSLog(@"打开数据库失败");
    }
}

- (IBAction)insert {
    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(@"插入数据成功");
        }
    }
}

- (IBAction)delete {
}

- (IBAction)updata {
}

- (IBAction)select {
    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(@"查询语句有问题");
    }
    
}
@end