FMDB详解（v2.7）

作者: 开发者老岳 | 来源:发表于2018-04-14 23:26 被阅读27次

FMDB详解（v2.7）
常用第三方框架
iOS数据库之FMDB、Realm、WCDB
笔记-FMDB详解
iOS FMDB使用详解
iOS FMDB库详解
iOS-FMDB详解及使用
iOS开发·FMDB的使用与知识梳理
FFDB
iOS数据持久化——FMDB（对SQLite的轻量级封装）

包含仨主要类：
FMDatabase、FMResultSet、FMDatabaseQueue

创建数据库

FMDatabase 是基于一个数据库文件的path创建的，该path有三种情况:

文件路径。文件不已经存在，若不存在会在该路径下创建一个空数据库文件。
空字符(@"")。此时会在临时目录创建一个空的数据库文件，当FMDatabase链接关闭时自动删除。
NULL。此时会在内存里创建一个空的数据库，统一链接关闭时删除。

NSString *path = [NSTemporaryDirectory() stringByAppendingPathComponent:@"tmp.db"];
FMDatabase *db = [FMDatabase databaseWithPath:path];

打开

操作数据库前，数据库必须是打开状态的。当空间不足或者没有权限的时候，就会打开失败。

if (![db open]) {
    db = nil;
    return;
}

Executing Updates

数据库语句除了select的都可以用update，包括CREATE, UPDATE, INSERT, ALTER, COMMIT, BEGIN等。
Executing Updates返回一个布尔类型值表示成功与否，返回NO的话表示发生错误，错误原因可以从-lastErrorMessage 和 -lastErrorCode方法里查找。

Executing Queries

主要就是select的方法通过调用几个-executeQuery...方法。查询成功返回FMResultSet对象，失败返回nil，失败错误原因同样可以从-lastErrorMessage 和 -lastErrorCode方法里查找。
若结果有多个，需要遍历结果的话，一般需要用到while方法，如：

FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];
while ([s next]) {
    //retrieve values for each record
}

结果只有一个的时候，也要调用next方法。如下：

FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];
if ([s next]) {
    int totalCount = [s intForColumnIndex:0];
}

FMResultSet有若干方法可用于解析返回的数据，如下：

- (int)intForColumn:(NSString*)columnName;
- (long)longForColumn:(NSString*)columnName;
- (BOOL)boolForColumn:(NSString*)columnName;
- (NSString*)stringForColumn:(NSString*)columnName;
- (NSDate*)dateForColumn:(NSString*)columnName;
- (id _Nullable)objectForColumn:(NSString*)columnName;
- (const unsigned char * _Nullable)UTF8StringForColumn:(NSString*)columnName;
...
这些方法里都有个对应的 ForColumnIndex:方法，如下：
- (int)intForColumnIndex:(int)columnIdx;，这些都是基于Column在结果中的位置去查找，而不是其ColumnName。
一般不用自己去-close一个FMResultSet，因为在结果集(FMResultSet)被释放或者父数据库close时会自动 close。

Closing

当执行完queries（查询）或updates(更新)数据库后，要手动-close掉FMDatabase连接，释放相应的资源。

 [db close];

Transactions

FMDatabase can begin and commit a transaction by invoking one of the appropriate methods or executing a begin/end transaction statement.

多语句和批量处理（Multiple Statements and Batch Stuff）

可以通过调用FMDatabase的 executeStatements:withResultBlock:方法来执行多条sql语句：

NSString *sql = @"create table bulktest1 (id integer primary key autoincrement, x text);"
                 "create table bulktest2 (id integer primary key autoincrement, y text);"
                 "create table bulktest3 (id integer primary key autoincrement, z text);"
                 "insert into bulktest1 (x) values ('XXX');"
                 "insert into bulktest2 (y) values ('YYY');"
                 "insert into bulktest3 (z) values ('ZZZ');";

success = [db executeStatements:sql];

sql = @"select count(*) as count from bulktest1;"
       "select count(*) as count from bulktest2;"
       "select count(*) as count from bulktest3;";

success = [self.db executeStatements:sql withResultBlock:^int(NSDictionary *dictionary) {
    NSInteger count = [dictionary[@"count"] integerValue];
    XCTAssertEqual(count, 1, @"expected one record for dictionary %@", dictionary);
    return 0;
}];

数据清理（Data Sanitization）

查询时问号?的使用：

NSInteger identifier = 42;
NSDate *date = [NSDate date];
NSString *comment = nil;

BOOL success = [db executeUpdate:@"INSERT INTO authors (identifier, date, comment) VALUES (?, ?, ?)", @(identifier), date, comment ?: [NSNull null]];
if (!success) {
    NSLog(@"error = %@", [db lastErrorMessage]);
}

Note: NSInteger应该转为NSNumber对象。同样，某条为空的时候，插入数据库的是[NSNull null]对象，本例中comment就用了?:方法处理的，非空就用comment，为空就用冒号后面的[NSNull null]。

冒号的使用：

NSDictionary *arguments = @{@"name": name, @"date": date, @"comment": comment ?: [NSNull null]};
BOOL success = [db executeUpdate:@"INSERT INTO authors (name, date, comment) VALUES (:name, :date, :comment)" withParameterDictionary:arguments];
if (!success) {
    NSLog(@"error = %@", [db lastErrorMessage]);
}

不要用 NSString的stringWithFormat:方法往sql语句里插入属性，要通过问号去插入。

FMDatabaseQueue 和线程安全

不要在多个线程里共享使用同一个FMDatabase的单例，因为会有线程安全的问题。多线程里要用FMDatabaseQueue，使用方法：

//创建队列
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:aPath];
//使用
[queue inDatabase:^(FMDatabase *db) {
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @1];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @2];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @3];

    FMResultSet *rs = [db executeQuery:@"select * from foo"];
    while ([rs next]) {
        …
    }
}];

FMDataBaseQueue使用事务：

[queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @1];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @2];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @3];

    if (whoopsSomethingWrongHappened) {
        *rollback = YES;
        return;
    }

    // etc ...
}];

FMDatabaseQueue能保证在多线程里任务顺序的执行，而不会冲突。