FMDB是一款簡潔、易用的封裝庫。它是對libsqlite3框架的封裝，用起來的步驟與SQLite使用類似，並且它對於多線程的並發操作進行了處理，所以是線程安全的。

1. FMDB 研究
2016/6/2
Jason

2. FMDB是什麼？
• FMDB是一款簡潔、易用的封裝庫。它是對
libsqlite3框架的封裝，用起來的步驟與SQLite
使用類似，並且它對於多線程的並發操作進
行了處理，所以是線程安全的。

3. FMDB V.S. SQLITE
• 優點
• 對多線程的並發操作進行處理，所以是線程安全的；
• 以OC的方式封裝了SQLite的C語言API，使用起來更加的方便；
• FMDB是輕量級的框架，使用靈活度高。
• 缺點
• 它是OC的語言封裝的，只能在iOS開發的時候使用，所以在實現跨平
台有局限性。

4. FMDB CLASS
• FMDatabase
• FMDatabase對象就代表一個單獨的SQLite資料庫，用來執行SQL
語句
• FMResultSet
• 使用FMDatabase執行查詢後的結果集
• FMDatabaseQueue
• 用於在多線程中執行多個查詢或更新，它是線程安全的

5. 建立資料庫和表格
-(void)createDatabaseAndTable
{
// 1.獲得數據庫文件的路徑
NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *fileName = [doc stringByAppendingPathComponent:@"student.sqlite"];
// 2.獲得數據庫
db = [FMDatabase databaseWithPath:fileName];
// 3.使用如下語句，如果打開失敗，可能是權限不足或者資源不足。通常打開完操作操作後，需要調用close方法來關閉數據庫。在和
數據庫交互之前，數據庫必須是打開的。如果資源或權限不足無法打開或創建數據庫，都會導致打開失敗。
if ([db open])
{
// 4.創建表單
BOOL result = [db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (number integer PRIMARY KEY
AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
if (result)
{
NSLog(@"創建表單成功");
}
}
}

6. 插入資料
-(void)insertData
{
NSString *name = @"HappyGirl";
int age = 16;
// 1.executeUpdate:不確定的參數用？來佔位（後面參數必須是oc對象，；代表語句結束）
[db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?,?);", name, @(age)];
// 2.executeUpdateWithForamat：不確定的參數用%@，%d等來佔位（參數為原始數據類型，執行語句不區分大小寫）
// [db executeUpdateWithFormat:@"insert into t_student (name, age) values ​​(%@,%i);", name, age];
// 3.參數是數組的使用方式
[db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?,?);" withArgumentsInArray:@[name, @(age)]];
}

7. 更新資料
-(void)updateData
{
// 1.不確定的參數用？來佔位（後面參數必須是OC對象，需要將int包裝成OC對象）
int idNum = 3;
[db executeUpdate:@"delete from t_student where number = ?;", @(idNum)];
// 2.不確定的參數用%@，%d等來佔位
[db executeUpdateWithFormat:@"delete from t_student where name = %@;", @"Happyboy"];
// 修改學生的名字
[db executeUpdate:@"update t_student set name = ? where name = ?", @"HappyGL", @"Happygirl"];
}

8. 丟棄表格
-(void)dropTable
{
// 如果表格存在則銷毀
[db executeUpdate:@"drop table if exists t_student;"];
}

9. 選擇資料
-(void)selectData
{
// 查詢整個表
FMResultSet *resultSet = [db executeQuery:@"select * from t_student;"];
// 根據條件查詢
// FMResultSet *resultSet = [db executeQuery:@"select * from t_student where number <?;", @(20)];
NSString *resultStr = @"";
// 遍歷結果集合
while ([resultSet next]) {
int idNum = [resultSet intForColumn:@"number"];
NSString *name = [resultSet stringForColumn:@"name"];
int age = [resultSet intForColumn:@"age"];
NSString *rowStr = [NSString stringWithFormat:@"number: %i, name: %@, age: %in", idNum, name, age];
resultStr = [resultStr stringByAppendingString:rowStr];
resultTV.text = resultStr;
NSLog(@"%@", rowStr);
}
}

10. 使用佇列
-(void)useQueue
{
NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString *fileName = [doc stringByAppendingPathComponent:@"student.sqlite"];
NSString *name = @"HappyJoy";
int age = 36;
// 1.創建隊列
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:fileName];
__block BOOL whoopsSomethingWrongHappened = YES;
// 2.把任務包裝到事務裡
[queue inTransaction:^(FMDatabase *dbx, BOOL *rollback)
{
whoopsSomethingWrongHappened &= [dbx executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?,?);", name, @(age)];
whoopsSomethingWrongHappened &= [dbx executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?,?);", name, @(age+1)];
whoopsSomethingWrongHappened &= [dbx executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?,?);", name, @(age+2)];
// 如果有錯誤返回
if (!whoopsSomethingWrongHappened)
{
*rollback = YES ;
return ;
}
}];
}

11. 參考
• FMDB
https://github.com/ccgus/fmdb
A Cocoa / Objective-C wrapper around SQLite
• 在iOS開發中使用FMDB
http://blog.devtang.com/2012/04/22/use-fmdb/
• 數據庫第三方框架FMDB詳細講解
http://www.jianshu.com/p/e2dbd69b6db2

12. • [iOS] FMDB
http://lokanghung.blogspot.tw/2014/05/ios-fmdb.html
• FMDB–更友好地操作SQLite數據庫
http://www.ios122.com/2015/09/fmdb/
• 用SQLite 和FMDB 替代Core Data
http://objccn.io/issue-4-3/
• 數據持久化(三)使用第三方類庫FMDB
http://www.kancloud.cn/digest/data/106693