優(yōu)秀的第三方庫，README 也是很優(yōu)秀的，理解了 README，會對使用帶來很多便利。
ARC 和 MRC
項目中使用 ARC 還是 MRC，對使用 FMDB 都沒有任何影響，F(xiàn)MDB 會在編譯項目時自動匹配。
使用
在 FMDB 中有三個重要的類：
FMDatabase：是一個提供 SQLite 數(shù)據(jù)庫的類，用于執(zhí)行 SQL 語句。
FMResultSet：用在FMDatabase中執(zhí)行查詢的結(jié)果的類。
FMDatabaseQueue：在多線程下查詢和更新數(shù)據(jù)庫用到的類。
數(shù)據(jù)庫創(chuàng)建
FMDatabase是通過一個 SQLite 數(shù)據(jù)庫文件路徑創(chuàng)建的，此路徑可以是以下三者之一：
一個文件的系統(tǒng)路徑。磁盤中可以不存在此文件，因為如果不存在會自動為你創(chuàng)建。
一個空的字符串@""。會在臨時位置創(chuàng)建一個空的數(shù)據(jù)庫，當FMDatabase連接關(guān)閉時，該數(shù)據(jù)庫會被刪除。
NULL。會在內(nèi)存中創(chuàng)建一個數(shù)據(jù)庫，當FMDatabase連接關(guān)閉時，該數(shù)據(jù)庫會被銷毀。
// 創(chuàng)建數(shù)據(jù)庫示例FMDatabase *db = [FMDatabase databaseWithPath:@"/tmp/tmp.db"];
打開數(shù)據(jù)庫
數(shù)據(jù)庫必須是打開狀態(tài)，才能與之交互。如果沒有足夠的資源和權(quán)限來打開\創(chuàng)建數(shù)據(jù)庫，數(shù)據(jù)庫會打開失敗。
數(shù)據(jù)庫更新
SQL 語句中除過SELECT語句都可以稱之為更新操作。包括CREATE，UPDATE，INSERT，ALTER，COMMIT，BEGIN，DETACH，DROP，END，EXPLAIN，VACUUM，REPLACE等。一般只要不是以SELECT開頭的 SQL 語句，都是更新語句。
執(zhí)行更新語句后會返回一個BOOL值，返回YES表示執(zhí)行更新語句成功，返回NO表示出現(xiàn)錯誤，可以通過調(diào)用-lastErrorMessage和-lastErrorCode方法獲取更多錯誤信息。
數(shù)據(jù)庫查詢
通過調(diào)用-executeQuery...方法之一執(zhí)行SELECT語句進行數(shù)據(jù)庫查詢操作。
執(zhí)行查詢操作后，如果成功會返回一個FMResultSet對象，反之會返回nil。通過-lastErrorMessage和-lastErrorCode方法可以確定為什么會查詢失敗。
為了遍歷查詢結(jié)果，需要while()循環(huán)，然后逐條記錄查看。在 FMDB 中，可以通過下面的簡單方式實現(xiàn)：
FMResultSet*s = [dbexecuteQuery:@"SELECT * FROM myTable"];while([snext]) {//每條記錄的檢索值}
即使只需要獲取一個數(shù)據(jù)，也還是必須在訪問查詢結(jié)果前調(diào)用-[FMResultSet next]。
// 示例FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];if([s next]) {inttotalCount = [s intForColumnIndex:0];}
FMResultSet提供了很多方便的方法來查詢數(shù)據(jù)：
intForColumn:
longForColumn:
longLongIntForColumn:
boolForColumn:
doubleForColumn:
stringForColumn:
dateForColumn:
dataForColumn:
dataNoCopyForColumn:
UTF8StringForColumn:
objectForColumn:
這些方法都有一個{type}ForColumnIndex:變體，是基于列的位置來查詢數(shù)據(jù)。
通常情況下，一個FMResultSet沒有必要手動-close，因為結(jié)果集合 (result set) 被釋放或者源數(shù)據(jù)庫關(guān)閉會自動關(guān)閉。
關(guān)閉數(shù)據(jù)庫
當對數(shù)據(jù)庫進行查詢和更新操作完成后，需要調(diào)用-close關(guān)閉數(shù)據(jù)庫FMDatabase的連接。
// 示例[db close];
事務
FMDatabase可以通過調(diào)用方法來開始和提交事務，也可以通過執(zhí)行開始\結(jié)束事務? (begin\end transaction) 語句。
多語句和批處理
FMDatabase可以通過-executeStatements:withResultBlock:方法在一個字符串中執(zhí)行多語句。
// 示例NSString *sql = @"createtablebulktest1 (idintegerprimarykeyautoincrement, xtext);"? ? ? ? ? ? ? ? "createtablebulktest2 (idintegerprimarykeyautoincrement, ytext);"? ? ? ? ? ? ? ? "createtablebulktest3 (idintegerprimarykeyautoincrement, ztext);"? ? ? ? ? ? ? ? "insertintobulktest1 (x)values('XXX');"? ? ? ? ? ? ? ? "insertintobulktest2 (y)values('YYY');"? ? ? ? ? ? ? ? "insertintobulktest3 (z)values('ZZZ');";success = [db executeStatements:sql];sql = @"selectcount(*)ascountfrombulktest1;"? ? ? "selectcount(*)ascountfrombulktest2;"? ? ? "selectcount(*)ascountfrombulktest3;";success = [self.db executeStatements:sql withResultBlock:^int(NSDictionary *dictionary) {? ? NSInteger count = [dictionary[@"count"] integerValue];? ? XCTAssertEqual(count, 1, @"expected one record for dictionary %@", dictionary);? ? return0;}];
數(shù)據(jù)處理
當給 FMDB 提供 SQL 語句時，在插入前不應該處理任何數(shù)據(jù)，而應該使用標準的 SQLite 的綁定語法。
// 示例INSERTINTOmyTableVALUES(?, ?, ?)
?問號在 SQLite 中意為即將插入的值的占位符，F(xiàn)MDB 執(zhí)行語句的方法都接受多個參數(shù) (或者參數(shù)集合，比如NSArray，NSDictionary，va_list)，它們都會正確轉(zhuǎn)義。
也可以使用命名參數(shù)語法：
// 示例INSERTINTOmyTableVALUES(:id, :name, :value)
這些參數(shù)必須以冒號開頭，SQLite 自身支持其他字符，但是命名時字典的鍵內(nèi)部以冒號開頭，就不能在你的字典的鍵中包含冒號。
// 示例NSDictionary*argsDict = [NSDictionarydictionaryWithObjectsAndKeys:@"My Name",@"name",nil];[db executeUpdate:@"INSERT INTO myTable (name) VALUES (:name)"withParameterDictionary:argsDict];
因此，不應該寫類似下面這行一樣的錯誤代碼：
// 錯誤示例[db executeUpdate:[NSString stringWithFormat:@"INSERTINTOmyTableVALUES(%@)", @"this has \" lots of ' bizarre \" quotes '"]];
而應該這樣寫：
// 正確示例[db executeUpdate:@"INSERTINTOmyTableVALUES(?)", @"this has \" lots of ' bizarre \" quotes '"];
所有傳遞給-executeUpdate:方法的參數(shù)都必須是對象。下面寫法執(zhí)行不會起作用而且會引發(fā)崩潰：
// 錯誤示例[db executeUpdate:@"INSERTINTOmyTableVALUES(?)", 42];
插入一個數(shù)的正確方法是把這個數(shù)字包裝成NSNumber對象：
// 正確示例[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumbernumberWithInt:42]];
也可以使用-execute*WithFormat:這個方法將數(shù)字轉(zhuǎn)換成字符串：
// 轉(zhuǎn)換成字符串示例[db executeUpdateWithFormat:@"INSERTINTOmyTableVALUES(@d)", 42];
-execute*WithFormat:這些方法后面都可以接格式字符串參數(shù)，以下 % 百分號格式符都是可以識別的：%@,%c,%s,%d,%D,%i,%u,%U,%hi,%hu,%qi,%qu,%f,%g,%ld,%lu,%lld,%llu。使用其他格式符可能會出現(xiàn)不可預知的問題。出于某種原因，可能需要在你的 SQL 語句中使用%字符，應該使用百分號轉(zhuǎn)義一下%%。
FMDatabaseQueue 隊列和線程安全
在多線程中同時使用 FMDatabase 單例是極其錯誤的想法，會導致每個線程創(chuàng)建一個 FMDatabase 對象。不要跨線程使用單例，也不要同時跨多線程，不然會奔潰或者異常。
因此不要實例化一個 FMDatabase 單例來跨線程使用。
相反，使用 FMDatabaseQueue，下面就是它的使用方法：
第一，創(chuàng)建隊列。
// 創(chuàng)建 FMdatabaseQueue 示例FMDatabaseQueue *queue= [FMDatabaseQueue databaseQueueWithPath:aPath];
然后這樣使用：
// 示例[queue inDatabase:^(FMDatabase *db) {? ? [db executeUpdate:@"INSERTINTOmyTableVALUES(?)", [NSNumber numberWithInt:1]];
[db executeUpdate:@"INSERTINTOmyTableVALUES(?)", [NSNumber numberWithInt:2]];
[db executeUpdate:@"INSERTINTOmyTableVALUES(?)", [NSNumber numberWithInt:3]];
FMResultSet *rs = [db executeQuery:@"select *fromfoo"];
while ([rs next]) {
...
}
}];
把操作放在事務中也很簡單，比如：
// 示例[queue inTransaction:^(FMDatabase *db,BOOL*rollback) {? ? [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumbernumberWithInt:1]];? ? [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumbernumberWithInt:2]];? ? [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumbernumberWithInt:3]];if(whoopsSomethingWrongHappened) {? ? ? ? *rollback =YES;return;? ? }// ...[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumbernumberWithInt:4]];}];
FMDatabase 將塊代碼 block 運行在一個串行隊列上，即使在多線程同時調(diào)用 FMDatabaseQueue 的方法，它們?nèi)匀贿€是順序執(zhí)行。這種查詢和更新方式不會影響其它，是線程安全的。
基于 block 自定義 SQLite 函數(shù)
這是可以的，例子可以在 main.m 中的makeFunctionNamed:方法查看。
Swift
在 Swift 項目中也可以使用 FMDB，需要做以下步驟：
將 FMDB 的.m和.h全部文件拖進你的項目。
如果 Xcode 提示創(chuàng)建橋接文件，需要點擊創(chuàng)建。如果沒有提示，且項目中也沒有橋接文件，需要手動添加。點此查看橋接文件更多信息
在橋接文件中，添加這行代碼：#import "FMDB.h"
可以從 "src/extra/Swift Extension" 文件夾中拷貝FMDatabaseVariadic.swift文件到項目中，就可以使用executeUpdate和executeQuery多參數(shù)了。
做完上述幾步，就可以使用 FMDatabase 寫 Swift 代碼了。
// 示例letdocumentsFolder =NSSearchPathForDirectoriesInDomains(.DocumentDirectory, .UserDomainMask,true)[0]asStringletpath = documentsFolder.stringByAppendingPathComponent("test.sqlite")letdatabase =FMDatabase(path: path)if!database.open() {println("Unable to open database")return}if!database.executeUpdate("create table test(x text, y text, z text)", withArgumentsInArray:nil) {println("create table failed:\(database.lastErrorMessage())")}if!database.executeUpdate("insert into test (x, y, z) values (?, ?, ?)", withArgumentsInArray: ["a","b","c"]) {println("insert 1 table failed:\(database.lastErrorMessage())")}if!database.executeUpdate("insert into test (x, y, z) values (?, ?, ?)", withArgumentsInArray: ["e","f","g"]) {println("insert 2 table failed:\(database.lastErrorMessage())")}ifletrs = database.executeQuery("select x, y, z from test", withArgumentsInArray:nil) {whilers.next() {letx = rs.stringForColumn("x")lety = rs.stringForColumn("y")letz = rs.stringForColumn("z")println("x =\(x); y =\(y); z =\(z)")? ? }}else{println("select failed:\(database.lastErrorMessage())")}database.close()
本文實際是對FMDB的 README 簡單翻譯，以方便使用 FMDB。
