SQLite 组件根据模型来管理数据库

数据库-sqlite基本操作封装

• 打开数据库
• 关闭数据库
• 语句分类
  • DML（增删改）
  • DQL (查询)
  • DDL (表格)
• 执行语句
  • 返回是否成功
• 查询语句
  • 返回结果集：有字典组成的数组，一个字典对应一条记录

操作

• 创建工程
• 导入框架
  • targets->Build Phases->Link Binary With Libararies -> libsqlite3.0.tbd
  • 导入头文件 #import "sqlite3.h"

数据库-sqlite基本封装

• .h

// 用户机制
// uid : nil  common.db
// uid: zhangsan  zhangsan.db
// 执行语句
+ (BOOL)deal:(NSString *)sql uid:(NSString *)uid;

// 返回值: 字典(一行记录)组成的数组
// 查询语句
+ (NSMutableArray <NSMutableDictionary *>*)querySql:(NSString *)sql uid:(NSString *)uid;

• .m

#import "WLFSqliteTool.h"
#import "sqlite3.h"

//#define kCachePath NSSearchPathForDirectoriesInDomains(NSCachesDirectory, NSUserDomainMask, YES).firstObject
#define kCachePath @"/Users/xsj/Desktop/SQLITE" //在桌面建立的文件夹利于查看


@implementation WLFSqliteTool
sqlite3 *ppDb = nil;

+ (BOOL)deal:(NSString *)sql uid:(NSString *)uid {
    
    
    // 打开数据库
    if (![self openDB:uid]) {
        NSLog(@"打开失败");
        return NO;
    }
    
    // 2. 执行语句
    BOOL result = sqlite3_exec(ppDb, sql.UTF8String, nil, nil, nil) == SQLITE_OK;
    
    // 3. 关闭数据库
    [self closeDB];
    
    return result;
    
}


+ (NSMutableArray <NSMutableDictionary *>*)querySql:(NSString *)sql uid:(NSString *)uid {
    [self openDB:uid];
    // 准备语句(预处理语句)
    
    // 1. 创建准备语句
    // 参数1: 一个已经打开的数据库
    // 参数2: 需要中的sql
    // 参数3: 参数2取出多少字节的长度 -1 自动计算 \0
    // 参数4: 准备语句
    // 参数5: 通过参数3, 取出参数2的长度字节之后, 剩下的字符串
    sqlite3_stmt *ppStmt = nil;
    if (sqlite3_prepare_v2(ppDb, sql.UTF8String, -1, &ppStmt, nil) != SQLITE_OK) {
        NSLog(@"准备语句编译失败");
        return nil;
    }
    
    // 2. 绑定数据(省略)
    
    // 3. 执行
    // 大数组
    NSMutableArray *rowDicArray = [NSMutableArray array];
    while (sqlite3_step(ppStmt) == SQLITE_ROW) {
        // 一行记录 -> 字典
        // 1. 获取所有列的个数
        int columnCount = sqlite3_column_count(ppStmt);
        
        NSMutableDictionary *rowDic = [NSMutableDictionary dictionary];
        [rowDicArray addObject:rowDic];
        // 2. 遍历所有的列
        for (int i = 0; i < columnCount; i++) {
            // 2.1 获取列名
            const char *columnNameC = sqlite3_column_name(ppStmt, i);
            NSString *columnName = [NSString stringWithUTF8String:columnNameC];
            
            // 2.2 获取列值
            // 不同列的类型, 使用不同的函数, 进行获取
            // 2.2.1 获取列的类型
            int type = sqlite3_column_type(ppStmt, i);
            // 2.2.2 根据列的类型, 使用不同的函数, 进行获取
            id value = nil;
            switch (type) {
                case SQLITE_INTEGER:
                    value = @(sqlite3_column_int(ppStmt, i));
                    break;
                case SQLITE_FLOAT:
                    value = @(sqlite3_column_double(ppStmt, i));
                    break;
                case SQLITE_BLOB:
                    value = CFBridgingRelease(sqlite3_column_blob(ppStmt, i));
                    break;
                case SQLITE_NULL:
                    value = @"";
                    break;
                case SQLITE3_TEXT:
                    value = [NSString stringWithUTF8String: (const char *)sqlite3_column_text(ppStmt, i)];
                    break;
                    
                default:
                    break;
            }
            
            [rowDic setValue:value forKey:columnName];
 
        }
    }
    
    
    // 4. 重置(省略)
    
    // 5. 释放资源
    sqlite3_finalize(ppStmt);
    
    [self closeDB];
    
    return rowDicArray;
}


#pragma mark - 私有方法
+ (BOOL)openDB:(NSString *)uid {
    NSString *dbName = @"common.sqlite";
    if (uid.length != 0) {
        dbName = [NSString stringWithFormat:@"%@.sqlite", uid];
    }
    
    NSString *dbPath = [kCachePath stringByAppendingPathComponent:dbName];
    
    // 1. 创建&打开一个数据库
    
    return  sqlite3_open(dbPath.UTF8String, &ppDb) == SQLITE_OK;
    
}

+ (void)closeDB {
    sqlite3_close(ppDb);
}

@end

• 测试
  • 利用单元测试UnitTest来查看这样就不必运行APP就可以查看代码是否符合逻辑。
  • 参考 juejin.cn/post/693979…

- (void)testExample {
    
    NSString *sql = @"create table if not exists t_stu(id integer primary key autoincrement, name text not null, age integer, score real)";
    
    BOOL result = [WLFSqliteTool deal:sql uid:nil];
    XCTAssertEqual(result, YES);

}

- (void)testQuery {
    
    NSString *sql = @"select * from t_stu";
    NSMutableArray *result = [WLFSqliteTool querySql:sql uid:nil];
    
    NSLog(@"%@", result);

}

根据数据模型动态建表

上述已经完成数据库的基本创建和查找，但是我设想的是能不能根据自己定的数据模型创建一个数据表呢，自己定义一个数据模型然后通过一些工具类，这样就不用谢一长段的sql语句了，对上面的工程进行改造

思路流程：

• 想办法拼凑拼接完整的SQL语句
• 表名称 ： 根据类名定义
• 字段名称 ： 类的成员变量 （通过协议去除不需要的成员变量）
• 字段类型 ： 类型编码到SQL类型的映射类型

return @{
             @"d": @"real", // double
             @"f": @"real", // float

             @"i": @"integer",  // int
             @"q": @"integer", // long
             @"Q": @"integer", // long long
             @"B": @"integer", // bool

             @"NSData": @"blob",
             @"NSDictionary": @"blob",
             @"NSMutableDictionary": @"blob",
             @"NSArray": @"blob",
             @"NSMutableArray": @"blob",

             @"NSString": @"text"
             };

• 主键： 通过协议

• 文件结构

数据库动态更新表-迁移数据

检测表格是否需要更新

• 修改字段名称
• 新增字段
• 删除字段

动态迁移数据

• 1.创建新的临时表格

• 2.以新表格为基准，从旧表中取出数据进行填充

  • 2.0 创建新的临时表
  • 2.1 根据主键，插入主键数据 （insert into 新表(主键) select 主键 from 旧表）
  • 2.2 按照新表的有效字段(旧表中包含该字段), 从旧表中更新数据到新表格中（update 新表 set 字段 = (select 字段 from 旧表 where 新表.字段 = 旧表.字段)）

• 3.删除旧表

• 4.修改临时表格的名称为新表

• 查看表数据 select sql from sqlite_master where type = 'table' and name = 'XMGStu'

字段改名处理

• 通过协议获取改名的映射字典
• 数据迁移时，进行过滤
  • 主键过滤
  • 没有被老表的字段集合包含; 并且更改后的字段名(如果有)也没有被老表包含

数据库-模型操作-保存/更新模型

• 1.检测表格是否存在，没有则创建
• 2.检测表格是否需要更新，需要则更新
• 3.插入或更新
  • 1.判断记录是否存在 存在，则拼接更新语句并执行。不存在，则拼接插入语句，并执行

数据库-模型操作-删除模型

• 删除指定某个模型
• 根据单个条件删除 key 关系 value
• 根据多个条件删除 keys 关系s values
• 根据删除sql语句执行删除

数据库-模型操作-查询模型

• 查询所有模型
• 根据单个条件查询 key 关系 value
• 根据多个条件查询 keys 关系s values
• 根据查询sql语句执行查询

数据库-模型操作-字典/数组属性处理

• 存储 -序列化data -> string
• 获取 -string -> data -> 反序列化
• 处理可变与不可变 -> 获取到该字段对应的类型，在反序列化中动态变更

存在问题-优化方案

• 无法创建复杂的表格，比如添加约束等行为

• 无法进行复杂的查询，比如多表联查

• 解决方案：暴露完整的sql语句类执行