美文网首页iOS DeveloperiOS开发
SQLite3以及FMDB的简单实用

SQLite3以及FMDB的简单实用

作者: Mark_Guan | 来源:发表于2016-12-07 13:45 被阅读401次

    SQLite

    SQLite是一款轻型的嵌入式数据库,它占用资源非常的低,在嵌入式设备中,可能只需要几百K的内存就够了。同时它的处理速度也是非常快速的。

    1. 因为在iOS中SQLite3依赖于系统提供的libsqlite.tbd这个类库,所以在使用之前首先我们需要导入这个类库;
    2. 打开数据库,打开数据库成功之后进行创表操作;
     // 数据库在沙盒中的存放路径;
        NSString *filename = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"shops.db"];
        
        //1.0 打开数据库;
        /* 参数一:数据库文件存放路径;如果数据库文件不存在, 系统会自动创建文件并且自动初始化数据库
           参数二:数据库实例对象;
         */
        if (sqlite3_open(filename.UTF8String, &_db) == SQLITE_OK) {
    
            const char *sql = "CREATE TABLE IF NOT EXISTS t_shop (id integer PRIMARY KEY, name text NOT NULL, price real);";
            
            //2.0 执行操作;
            char *errmsg = NULL;
            /* 参数一:数据库实例对象;
               参数二:执行的SQL语句;
             */
            
            if (sqlite3_exec(self.db, sql, NULL, NULL, &errmsg)!= SQLITE_OK) {
               
                 NSLog(@"创表失败--%s", errmsg);
            }
        } else {
            NSLog(@"打开数据库失败");
        }  
    

    在上面的代码中,我们做了两个操作,首先打开数据库我们使用了sqlite3_open这个方法,该方法根据文件路径打开数据库,如果不存在,则会创建一个新的数据库。如果result等于常量SQLITE_OK,则表示成功打开数据库。该方法有两个参数,如下:

    int sqlite3_open(
        const char *filename,   // 数据库的文件路径
        sqlite3 **ppDb          // 数据库实例
    );
    

    其次,我们使用sqlite3_exec方法来执行建表操作。该方法适合于查询结果集之外的任何操作。

    2.执行任何SQL语句
    int sqlite3_exec(
        sqlite3*,                                  // 一个打开的数据库实例
        const char *sql,                           // 需要执行的SQL语句
        int (*callback)(void*,int,char**,char**),  // SQL语句执行完毕后的回调
        void *,                                    // 回调函数的第1个参数
        char **errmsg                              // 错误信息
    );
    
    1. 执行查询操作;
     NSString * sql=[NSString stringWithFormat:@"SELECT name,price FROM %@;",tableName];
        
        // sqlite3_stmt实例,用来获得数据库数据
        sqlite3_stmt *stmt = NULL;
     
        // 预准备,其实就是分析SQL语句的合法性
        if (sqlite3_prepare_v2(self.db, sql.UTF8String, -1, &stmt, NULL) == SQLITE_OK) {
            // 返回SQLITE_ROW代表成功取出一条数据
            while (sqlite3_step(stmt) == SQLITE_ROW) {
                
                const char *name = (const char *)sqlite3_column_text(stmt, 0);
                
                const char *price = (const char *)sqlite3_column_text(stmt, 1);
            }
        }
    

    上面用到了两个方法:

    3.检查SQL语句的合法性(查询前的准备)
    int sqlite3_prepare_v2(
        sqlite3 *db,            // 数据库实例
        const char *zSql,       // 需要检查的SQL语句
        int nByte,              // SQL语句的最大字节长度,-1代表系统会帮我们自动计算
        sqlite3_stmt **ppStmt,  // sqlite3_stmt实例,用来获得数据库数据
        const char **pzTail
    );
    4.查询一行数据
    int sqlite3_step(sqlite3_stmt*); // 如果查询到一行数据,就会返回SQLITE_ROW
    

    查询分三个阶段:
    准备阶段:sqlite3_prepare_v2()
    执行阶段:sqlte3_step()
    终止阶段:sqlite3_finalize()

    1. 使用约束变量
      sqlite3_bind是用来给sqlite3_stmt *pStmt语句增加值的,对于不同类型的参数要选用不同的函数。
      例如,要执行带两个约束变量的插入操作,第一个变量是int类型,第二个是C字符串:
    char *sql = "insert into oneTable values (?, ?);";
    sqlite3_stmt *stmt;
    if (sqlite3_prepare_v2(database, sql, -1, &stmt, nil) == SQLITE_OK) {
       sqlite3_bind_int(stmt, 1, 235);
       sqlite3_bind_text(stmt, 2, "valueString", -1, NULL);
    }
    if (sqlite3_step(stmt) != SQLITE_DONE)
    NSLog(@"Something is Wrong!");
    sqlite3_finalize(stmt);
    

    这里,sqlite3_bind_int(stmt, 1, 235);有三个参数:
    第一个是sqlite3_stmt类型的变量
    第二个是所约束变量的标签index,(从1开始)
    第三个参数是要加的值
    有一些函数多出两个变量,例如
    sqlite3_bind_text(stmt, 2, "valueString", -1, NULL);
    第四个参数代表第三个参数中需要传递的长度。对于C字符串来说,-1表示传递全部字符串。
    第五个参数是一个回调函数,比如执行后做内存清除工作。

    1. 利用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);  // 字符串数据
    

    因为获取某一列的值我们不知道具体的类型,所以我们可以遍历字段,然后根据类型自动匹配:

        
        //存放最终的返回结果;
        NSMutableArray * muArray=[NSMutableArray array];
        
        //2.0 执行预处理 获取结果,如果下一行有记录,就会自动返回SQLITE_ROW,同时会自动将指针移动到下一行;
        while (sqlite3_step(ppStmt) == SQLITE_ROW) {
     
            //存放当前行的数据;
            NSMutableDictionary * mnDic=[NSMutableDictionary dictionary];
            [muArray addObject:mnDic];
            
            //获取当前行 中 列的个数;
            int columnCount= sqlite3_column_count(ppStmt);
            
            for(int i=0;i<columnCount;i++ )
            {
           
             //获取列名称;
             NSString * columnName=[NSString stringWithUTF8String:sqlite3_column_name(ppStmt, i)];
                
                //获取列的类型
              int columnType= sqlite3_column_type(ppStmt, i);
                
                //匹配类型;
                id value;
                //#define SQLITE_INTEGER  1
                //#define SQLITE_FLOAT    2
                //#define SQLITE_BLOB     4
                //#define SQLITE_NULL     5
                //#define SQLITE3_TEXT    3
                switch (columnType) {
                    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:
                    {
                        const char * columnValue=(const char *)sqlite3_column_text(ppStmt, i);
                        value=[NSString stringWithUTF8String:columnValue];
                        break;
                    }
                    
                    default:
                        break;
                }
                
                [mnDic setValue:value forKeyPath:columnName];
            }
        }
        
        //3.0 关闭数据库
        sqlite3_finalize(ppStmt);//销毁准备语句,防止内存泄漏;
        [self closeDBWithUID:uid];
        return  muArray;
    

    FMDB

    FMDB是iOS平台的SQLite数据库框架,它以OC的方式封装了SQLite的C语言API,使用起来更加面向对象,省去了很多麻烦的C语言代码,对比苹果自带的Core Data框架,更加轻量级和灵活,提供了多线程安全的数据库操作方法,有效地防止数据混乱。
    FMDB有三个主要的类:
    FMDatabase:一个FMDatabase对象就代表一个单独的SQLite数据库
    FMResultSet:使用FMDatabase执行查询后的结果集
    FMDatabaseQueue:用于在多线程中执行多个查询或更新,它是线程安全的
    在FMDB中,除查询以外的所有操作,都称为“更新”
    create、drop、insert、update、delete

    更新操作
    使用executeUpdate:方法执行更新:

    - (BOOL)executeUpdate:(NSString*)sql, ...
    - (BOOL)executeUpdateWithFormat:(NSString*)format, ...
    - (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments
    
    

    查询操作

    - (FMResultSet *)executeQuery:(NSString*)sql, ...
    - (FMResultSet *)executeQueryWithFormat:(NSString*)format, ...
    - (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments
    

    例如:

    // 查询数据
    FMResultSet *result = [_db executeQuery:@"SELECT * FROM t_student"];
    
    // 遍历结果集
    while ([result next]) {
        NSString *name = [rs stringForColumn:@"name"];
        int age = [rs intForColumn:@"age"];
        double score = [rs doubleForColumn:@"score"];
    }
    

    FMDatabaseQueue
    FMDatabase这个类是线程不安全的,如果在多个线程中同时使用一个FMDatabase实例,会造成数据混乱等问题,为了保证线程安全,FMDB提供了非常方便快捷的FMDatabaseQueue类:

    FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:path];
    [queue inDatabase:^(FMDatabase *db) {
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Jack"];
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Rose"];
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Jim"];
        
        FMResultSet *rs = [db executeQuery:@"select * from t_student"];
        while ([rs next]) {
            // …
        }
    }];
    
    

    使用事物:

    [queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Jack"];
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Rose"];
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Jim"];
        
        FMResultSet *result = [db executeQuery:@"select * from t_student"];
        while ([result next]) {
            // …
        }
    }];
    
    #import <Foundation/Foundation.h>
    
    @interface StatusTool : NSObject
    /**
     *  根据请求参数去沙盒中加载缓存的微博数据
     *
     *  @param params 请求参数
     */
    + (NSArray *)statusesWithParams:(NSDictionary *)params;
    
    /**
     *  存储微博数据到沙盒中
     *
     *  @param statuses 需要存储的微博数据
     */
    + (void)saveStatuses:(NSArray *)statuses;
    @end
    

    具体实现:

    #import "StatusTool.h"
    #import "FMDB.h"
    
    @implementation StatusTool
    
    static FMDatabase *_db;
    + (void)initialize
    {
        // 1.通过指定SQLite数据库文件路径来创建FMDatabase对象
        NSString *path = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject] stringByAppendingPathComponent:@"Statuses.db"];
        _db = [FMDatabase databaseWithPath:path];
        
        //2.0 打开数据库
        [_db open];
        
        // 3.0创表
        [_db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_status (id integer PRIMARY KEY, status blob NOT NULL, idstr text NOT NULL);"];
    }
    
    + (NSArray *)statusesWithParams:(NSDictionary *)params
    {
        // 根据请求参数生成对应的查询SQL语句
        NSString *sql = nil;
        if (params[@"since_id"]) {
            sql = [NSString stringWithFormat:@"SELECT * FROM t_status WHERE idstr > %@ ORDER BY idstr DESC LIMIT 20;", params[@"since_id"]];
        } else if (params[@"max_id"]) {
            sql = [NSString stringWithFormat:@"SELECT * FROM t_status WHERE idstr <= %@ ORDER BY idstr DESC LIMIT 20;", params[@"max_id"]];
        } else {
            sql = @"SELECT * FROM t_status ORDER BY idstr DESC LIMIT 20;";
        }
        
        // 执行SQL
        FMResultSet *set = [_db executeQuery:sql];
        NSMutableArray *statuses = [NSMutableArray array];
        while (set.next) {
            //可以根据columnName来获取数据,跟不用根据列号;
            NSData *statusData = [set objectForColumnName:@"status"];
            NSDictionary *status = [NSKeyedUnarchiver unarchiveObjectWithData:statusData];
            [statuses addObject:status];
        }
        return statuses;
    }
    
    + (void)saveStatuses:(NSArray *)statuses
    {
        // 要将一个对象存进数据库的blob字段,最好先转为NSData,一个对象要遵守NSCoding协议,实现协议中相应的方法,才能转成NSData
        for (NSDictionary *status in statuses) {
            // NSDictionary --> NSData
            NSData *statusData = [NSKeyedArchiver archivedDataWithRootObject:status];
            [_db executeUpdateWithFormat:@"INSERT INTO t_status(status, idstr) VALUES (%@, %@);", statusData, status[@"idstr"]];
    
        }
    }
    @end
    

    SQLite进行事务的SQL语句:

    只要在执行SQL语句前加上以下的SQL语句,就可以使用事务功能了:
    开启事务的SQL语句,"begin transaction;"
    进行提交的SQL语句,"commit transaction;"
    进行回滚的SQL语句,"rollback transaction;"
    

    只有事务提交了,开启事务期间的操作才会生效

    相关文章

      网友评论

        本文标题:SQLite3以及FMDB的简单实用

        本文链接:https://www.haomeiwen.com/subject/ppudmttx.html