iOS数据持久化 - SQLite

一.简介

  • 特点
    1.SQLite是嵌入式\移动客户端使用的轻量级关系数据库.
    2.SQLite占用资源非常少,在嵌入式设备中只需要几百K的内存就够了,目前应用于Android、iOS、Windows Phone等智能手机.
    3.SQLite是无类型的数据库,可以保存任何类型的数据,对于SQLite来说对字段不指定类型是完全有效的.
  • 近似类型
    SQLite为了和其他数据库兼容性最大化,支持“近似类型”的观点,列的"近似类型"指的是存储列上数据的推荐类型.
  • 近似类型规则

如果类型字符串中包含“int”,那么该字段的亲缘类型是INTEGER
如果类型字符串中包含“char”、“clob”或“text”,那么该字段的亲缘类型是TEXT,如VARCHAR
如果类型字符串中包含“blob”,那么该字段的亲缘类型是none
如果类型字符串中包含“real”、“floa”或“doub”,那么该字段的亲缘类型是real
其余情况下,字段的亲缘类型为NUMERIC

  • 字段约束条件

not null - 非空
unique - 唯一
primary key - 主键
foreign key - 外键
check - 条件检查,确保一列中的所有值满足一定条件
default - 默认
autoincreatement - 自增型变量

  • 建议使用场景
    储存大量需要增删改查且数据之间有一定逻辑关系的数据.

二.使用

  • 注意
    程序中一般只有一个数据库,可以在数据库中创建多张表来保存不同的信息,千万不要创建多个数据库,每个数据库中只有一张表,因为不断的连接,关闭数据库非常消耗性能.
  • 添加依赖
    加入libsqlite3.0.tbd框架以及引入sqlite3.h头文件.
  • 打开数据库
    创建一个类对数据库进行操作
#import "SQLService.h"

@implementation SQLService

// 创建数据库指针
static sqlite3 *sql = nil;

// 打开数据库
+ (sqlite3 *)open {
    
    // 此方法的主要作用是打开数据库
    // 返回值是一个数据库指针
    // 因为这个数据库在很多的SQLite API(函数)中都会用到,我们声明一个类方法来获取,更加方便

    // 懒加载
    if (sql != nil) {
        return sql;
    }
    
    // 获取Documents路径
    NSString *docPath = [NSSearchPathForDirectoriesInDomains(NSDocumentationDirectory, NSUserDomainMask, YES) lastObject];
    
    // 生成数据库文件在沙盒中的路径
    NSString *sqlPath = [docPath stringByAppendingPathComponent:@"studentDB.sqlite"];
    
    // 创建文件管理对象
    NSFileManager *fileManager = [NSFileManager defaultManager];
    
    // 判断沙盒路径中是否存在数据库文件,如果不存在才执行拷贝操作,如果存在不在执行拷贝操作
    if ([fileManager fileExistsAtPath:sqlPath] == NO) {
        // 获取数据库文件在包中的路径
        NSString *filePath = [[NSBundle mainBundle] pathForResource:@"studentDB" ofType:@"sqlite"];
        
        // 使用文件管理对象进行拷贝操作
        // 第一个参数是拷贝文件的路径
        // 第二个参数是将拷贝文件进行拷贝的目标路径
        [fileManager copyItemAtPath:filePath toPath:sqlPath error:nil];
        
    }
    
    // 打开数据库需要使用一下函数
    // 第一个参数是数据库的路径(因为需要的是C语言的字符串,而不是NSString所以必须进行转换)
    // 第二个参数是指向指针的指针
    sqlite3_open([sqlPath UTF8String], &sql);
    
    return sql;
}
  • 关闭数据库
// 关闭数据库
+ (void)close {
    // 关闭数据库
    sqlite3_close(db);
    // 将数据库的指针置空
    db = nil;
}
  • 创建表
    // 将建表的sql语句放入NSString对象中
    NSString *sql = @"create table if not exists stu (ID integer primary key, name text not null, gender text default '男')";
    // 打开数据库
    sqlite3 *sql = [SQLService open];
    
    // 执行sql语句
    int result = sqlite3_exec(sql, sql.UTF8String, nil, nil, nil);
    
    if (result == SQLITE_OK) {
        NSLog(@"建表成功");
    } else {
        NSLog(@"建表失败");
    }
    
    // 关闭数据库
    [SQLService close];
  • 查询表(全部数据)
// 获取表中保存的所有学生
+ (NSArray *)allStudents {
    // 打开数据库
    sqlite3 *sql = [SQLService open];
    
    // 创建一个语句对象
    sqlite3_stmt *stmt = nil;
    
    // 声明数组对象
    NSMutableArray *mArr = nil;
    
    // 此函数的作用是生成一个语句对象,此时sql语句并没有执行,创建的语句对象,保存了关联的数据库,执行的sql语句,sql语句的长度等信息
    int result = sqlite3_prepare_v2(sql, "select * from Students", -1, &stmt, nil);
    if (result == SQLITE_OK) {
        
        // 为数组开辟空间
        mArr = [NSMutableArray arrayWithCapacity:0];
        
        // SQLite_ROW仅用于查询语句,sqlite3_step()函数执行后的结果如果是SQLite_ROW,说明结果集里面还有数据,会自动跳到下一条结果,如果已经是最后一条数据,再次执行sqlite3_step(),会返回SQLite_DONE,结束整个查询
        while (sqlite3_step(stmt) == SQLITE_ROW) {
            
            // 获取记录中的字段值
            // 第一个参数是语句对象,第二个参数是字段的下标,从0开始
            int ID = sqlite3_column_int(stmt, 0);
            const unsigned char *cName = sqlite3_column_text(stmt, 1);
            const unsigned char *cGender = sqlite3_column_text(stmt, 2);
            
            // 将获取到的C语言字符串转换成OC字符串
            NSString *name = [NSString stringWithUTF8String:(const char *)cName];
            NSString *gender = [NSString stringWithUTF8String:(const char *)cGender];
            Student *student = [Student studentWithID:ID name:name gender:gender];
            
            // 添加学生信息到数组中
            [mArr addObject:student];
        }
    }
    
    // 关闭数据库
    sqlite3_finalize(stmt);

    return mArr;
}
  • 查询表(指定数据)
// 根据指定的ID,查找相对应的学生
+ (Student *)findStudentByID:(int)ID {
    // 打开数据库
    sqlite3 *sql = [SQLService open];
    
    // 创建一个语句对象
    sqlite3_stmt *stmt = nil;
    
    Student *student = nil;
    
    // 生成语句对象
    int result = sqlite3_prepare_v2(sql, "select * from Students where ID = ?", -1, &stmt, nil);
    
    if (result == SQLITE_OK) {
        
        // 如果查询语句或者其他sql语句有条件,在准备语句对象的函数内部,sql语句中用?来代替条件,那么在执行语句之前,一定要绑定
        // 1代表sql语句中的第一个问号,问号的下标是从1开始的
        sqlite3_bind_int(stmt, 1, ID);
        
        if (sqlite3_step(stmt) == SQLITE_ROW) {
            
            // 获取记录中的字段信息
            const unsigned char *cName = sqlite3_column_text(stmt, 1);
            const unsigned char *cGender = sqlite3_column_text(stmt, 2);
            
            // 将C语言字符串转换成OC字符串
            NSString *name = [NSString stringWithUTF8String:(const char *)cName];
            NSString *gender = [NSString stringWithUTF8String:(const char *)cGender];
            
            student = [Student studentWithID:ID name:name gender:gender];
            
        }
    }
    
    // 先释放语句对象
    sqlite3_finalize(stmt);

    return student;
}

  • 表中添加数据
// 插入一条记录
+ (void)insertStudentWithID:(int)ID name:(NSString *)name gender:(NSString *)gender {
    
    // 打开数据库
    sqlite3 *sql = [SQLService open];
    
    sqlite3_stmt *stmt = nil;
    
    int result = sqlite3_prepare_v2(sql, "insert into Students values(?,?,?)", -1, &stmt, nil);
    
    if (result == SQLITE_OK) {
        // 绑定
        sqlite3_bind_int(stmt, 1, ID);
        sqlite3_bind_text(stmt, 2, [name UTF8String], -1, nil);
        sqlite3_bind_text(stmt, 3, [gender UTF8String], -1, nil);
        
        // 插入与查询不一样,执行结果没有返回值
        sqlite3_step(stmt);
        
    }
    
    // 释放语句对象
    sqlite3_finalize(stmt);
    
}
  • 更新表内数据
// 更新指定ID下的姓名和性别
+ (void)updateStudentName:(NSString *)name gender:(NSString *)gender forID:(int)ID {
    
    // 打开数据库
    sqlite3 *sql = [SQLService open];
    
    sqlite3_stmt *stmt = nil;
    
    int result = sqlite3_prepare_v2(sql, "update Student set name = ?, gender = ? where ID = ?", -1, &stmt, nil);
    if (result == SQLITE_OK) {
        sqlite3_bind_text(stmt, 1, [name UTF8String], -1, nil);
        sqlite3_bind_text(stmt, 2, [gender UTF8String], -1, nil);
        sqlite3_bind_int(stmt, 3, ID);
        
        sqlite3_step(stmt);
    }
    sqlite3_finalize(stmt);
}
  • 删除表内数据
// 根据指定ID删除学生
+ (void)deleteStudentByID:(int)ID {
    
    // 打开数据库
    sqlite3 *sql = [SQLService open];
    
    sqlite3_stmt *stmt = nil;
    
    int result = sqlite3_prepare_v2(sql, "delete from Students where ID = ?", -1, &stmt, nil);
    
    if (result == SQLITE_OK) {
        sqlite3_bind_int(stmt, 1, ID);
        sqlite3_step(stmt);
    }
    
    sqlite3_finalize(stmt); 
}

你可能感兴趣的:(iOS数据持久化 - SQLite)