iOS-SQLite3的使用详解

序言

SQLite是目前主流的嵌入式关系型数据库，其最主要的特点就是轻量级、跨平台，当前很多嵌入式操作系统都将其作为数据库首选。虽然SQLite是一款轻型数据库，但是其功能也绝不亚于很多大型关系数据库。学习数据库就要学习其相关的定义、操作、查询语言，也就是大家日常说得SQL语句。和其他数据库相比，SQLite中的SQL语法并没有太大的差别，因此这里对于SQL语句的内容不会过多赘述，大家可以参考SQLite中其他SQL相关的内容，这里还是重点讲解iOS中如何使用SQLite构建应用程序。

先看一下SQLite数据库的几个特点：

• 基于C语言开发的轻型数据库

• 在iOS中需要使用C语言语法进行数据库操作、访问（无法使用ObjC直接访问，因为libqlite3框架基于C语言编写）

• SQLite中采用的是动态数据类型，即使创建时定义了一种类型，在实际操作时也可以存储其他类型，但是推荐建库时使用合适的类型（特别是应用需要考虑跨平台的情况时）

• 建立连接后通常不需要关闭连接（尽管可以手动关闭）

二 使用

2.1 在iOS中使用SQLite3，首先要添加库文件libsqlite3.tbd

image.png

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

#import <sqlite3.h>

2.3 打开数据库

@implementation ViewController {
    sqlite3 *_db;    // 句柄
}

// 打开数据库
- (void)openSqlDataBase {
    // _db是数据库的句柄,即数据库的象征,如果对数据库进行增删改查,就得操作这个示例
    
    // 获取数据库文件的路径
    NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    NSString *fileName = [docPath stringByAppendingPathComponent:@"student.sqlite"];
    NSLog(@"fileNamePath = %@",fileName);
    // 将 OC 字符串转换为 C 语言的字符串
    const char *cFileName = fileName.UTF8String;
    
    // 打开数据库文件(如果数据库文件不存在,那么该函数会自动创建数据库文件)
    int result = sqlite3_open(cFileName, &_db);
    
    if (result == SQLITE_OK) {  // 打开成功
        NSLog(@"成功打开数据库");
    } else {
        NSLog(@")打开数据库失败");
    }
}

运行结果

image.png

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

image.png

2.4 创建表

- (void)openSqlDataBase {
    // _db是数据库的句柄,即数据库的象征,如果对数据库进行增删改查,就得操作这个示例
    
    // 获取数据库文件的路径
    NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    NSString *fileName = [docPath stringByAppendingPathComponent:@"student.sqlite"];
    NSLog(@"fileNamePath = %@",fileName);
    // 将 OC 字符串转换为 C 语言的字符串
    const char *cFileName = fileName.UTF8String;
    
    // 打开数据库文件(如果数据库文件不存在,那么该函数会自动创建数据库文件)
    int result = sqlite3_open(cFileName, &_db);
    
    if (result != SQLITE_OK) {  // 打开失败
        NSLog(@"打开数据库失败");
        return;
    }
    NSLog(@"打开数据库成功");
    
    // 创建表
    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(@"创建表失败");
        printf("创表失败---%s----%s---%d",errMsg,__FILE__,__LINE__);
    }
}

运行结果

image.png

沙盒查看表结构

image.png

创建表的时候，一定要加IF NOT EXISTS

将 sql 语句改成下面这句

const char *sql = "CREATE TABLE t_students (id integer PRIMARY KEY AUTOINCREMENT,name text NOT NULL,age integer NOT NULL);";

运行结果

image.png

2.5 插入数据

// 插入数据
- (void)insertData {
    for (int i = 0; i < 20; i++) {
        NSString *name = [NSString stringWithFormat:@"韩雪--%d",arc4random_uniform(100)];
        int age = arc4random_uniform(20) + 10;
        
        // 拼接 sql 语句
        NSString *sql = [NSString stringWithFormat:@"INSERT INTO t_students (name,age) VALUES ('%@',%d);",name,age];
        
        // 执行 sql 语句
        char *errMsg = NULL;
        int result = sqlite3_exec(_db, sql.UTF8String, NULL, NULL, &errMsg);
        
        if (result == SQLITE_OK) {
            NSLog(@"插入数据成功 - %@",name);
        } else {
            NSLog(@"插入数据失败 - %s",errMsg);
        }
    }
}

运行结果

image.png

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

image.png

2.6 选择查询操作

函数说明

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

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 */
);

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

实例代码

// 查询操作
- (void)sqlData {
    // sql语句
    const char *sql="SELECT id,name,age FROM t_students WHERE age<20;";
    sqlite3_stmt *stmt = NULL;
    
    // 进行查询前的准备工作
    if (sqlite3_prepare_v2(_db, sql, -1, &stmt, NULL) == SQLITE_OK) {   // sql语句没有问题
        NSLog(@"sql语句没有问题");
        
        // 每调用一次sqlite3_step函数，stmt就会指向下一条记录
        while (sqlite3_step(stmt) == SQLITE_ROW) {  // 找到一条记录
            // 取出数据
            int ID = sqlite3_column_int(stmt, 0);   // 取出第0列字段的值
            const unsigned char *name = sqlite3_column_text(stmt, 1);   // 取出第1列字段的值
            int age = sqlite3_column_int(stmt, 2);  // 取出第2列字段的值
            printf("%d %s %d\n",ID,name,age);
        }
    } else {
        NSLog(@"查询语句有问题");
    }
}

运行结果

image.png

结言

这里只是简单介绍SQLite3的使用方法，更多复杂操作靠各位自己啦。

---

本文参考

数据库sqlite3的使用-ios中引用方法

---

更多同类型文章参考
iOS-SQLite3的使用详解
iOS-CoreData详解与使用
iOS-FMDB详解及使用
iOS SQLite、CoreData、FMDB数据库详解

---

项目链接地址 - sqlite3Demo