初識FMDB

iOS中原生的SQLite API在進行數據存儲的時候，需要使用C語言中的函數，操作比較麻煩。於是，就出現了一系列將SQLite API進行封裝的庫，例如FMDB、PlausibleDatabase、sqlitepersistentobjects等。

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

FMDB PK Sqlite

• 優點:

• 對多線程的並發操作進行處理，所以是線程安全的；

• 以OC的方式封裝了SQLite的C語言API，使用起來更加的方便；

• FMDB是輕量級的框架，使用靈活。

• 缺點:

• 因為它是OC的語言封裝的，只能在ios開發的時候使用，所以在實現跨平台操作的時候存在局限性。

FMDB框架中重要的框架類

• FMDatabase

• FMDatabase對象就代表一個單獨的SQLite數據庫，用來執行SQL語句

• FMResultSet

• 使用FMDatabase執行查詢後的結果集

• FMDatabaseQueue

• 用於在多線程中執行多個查詢或更新，它是線程安全的

FMDB使用步驟

• 下載FMDB文件GitHub,並將FMDB文件夾添加到項目中（也可使用CocoaPods導入）

• 導入libsqlite3.0框架，導入頭文件FMDatabase.h

• 代碼實現，與SQLite使用步驟相似，創建數據庫路徑，獲得數據庫路徑，打開數據庫，然後對數據庫進行增、刪、改、查操作，最後關閉數據庫。

step.png

數據庫創建

創建FMDatabase對象時參數為SQLite數據庫文件路徑，該路徑可以是以下三種方式之一

• 文件路徑。該文件路徑無需真實存在，如果不存在會自動創建

• 空字符串(@“”)。表示會在臨時目錄創建一個空的數據庫，當FMDatabase連接關閉時，文件也會被刪除

• NULL。將創建一個內在數據庫，同樣的，當FMDatabase連接關閉時，數據將會被銷毀

• 本文中使用的測試模型類.h

student.png

數據庫使用FMDB框架代碼操作

• 使用FMDataBase類建立數據庫

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

• 查看sql表
  

• 根據路徑fileName在Finder中搜索.sqlite文件，並復制到桌面

• 使用火狐浏覽器工具下的SQLite Manager打開.sqlite文件

2.png

• 數據表結構

sql.png

使用FMDataBase類執行數據庫命令SQL

一切不是SELECT命令的命令都視為更新。這包括 CREAT,UPDATE,INSERT,ALTER,BEGIN,COMMIT,DETACH,DELETE,DROP,END,EXPLAIN,VACUUM,REPLACE等。

簡單來說，只要不是以SELECT開頭的命令都是更新命令。

執行更新返回一個BOOL值。YES表示 執行成功，否則表示有錯誤。你可以調用 -lastErrorMessage 和 -lastErrorCode方法來得到更多信息。

• 使用FMDataBase類執行數據庫插入命令SQLinsert into

  int age = 42;
 //1.executeUpdate:不確定的參數用？來占位（後面參數必須是oc對象，；代表語句結束）
 [self.db executeUpdate:@“INSERT INTO t_student (name, age) VALUES (?,?);”,name,@(age)];
    //2.executeUpdateWithForamat：不確定的參數用%@，%d等來占位 （參數為原始數據類型，執行語句不區分大小寫）
 [self.db executeUpdateWithForamat:@“insert into t_student (name,age) values (%@,%i);”,name,age];
    //3.參數是數組的使用方式
 [self.db executeUpdate:@“INSERT INTO     
 t_student(name,age) VALUES  (?,?);”withArgumentsInArray:@[name,@(age              ? )]];

• 使用FMDataBase類執行數據庫刪除命令SQLdelete
  

  //1.不確定的參數用？來占位 （後面參數必須是oc對象,需要將int包裝成OC對象）
  int idNum = 101;
    [self.db executeUpdate:@“delete from t_student where id = ?;”,@(idNum)];
   //2.不確定的參數用%@，%d等來占位
    [self.db executeUpdateWithFormat:@“delete from t_student where name = %@;”,@“apple_name”];

• 使用FMDataBase類執行數據庫修改命令SQLupdate
  

  //修改學生的名字
  [self.db executeUpdate:@“update t_student set name = ? where name = ?”,newName,oldName];

• 使用FMDataBase類執行數據庫查詢命令SQLselect ... from
  

• SELECT命令就是查詢，執行查詢的方法是以-excuteQuery開頭的。

• 執行查詢時，如果成功返回FMResultSet對象，錯誤返回nil。與執行更新相當，支持使用NSError參數。

• 同時，你也可以使用-lastErrorCode和-lastErrorMessage獲知錯誤信息。

• FMResultSet獲取不同數據格式的方法

• intForColumn:

• longForColumn:

• longLongIntForColumn:

• boolForColumn:

• doubleForColumn:

• stringForColumn:

• dataForColumn:

• dataNoCopyForColumn:

• UTF8StringForColumnIndex:

• objectForColumn:

• 使用FMResultSet獲取查詢語句結果

 //查詢整個表

FMResultSet *resultSet = [self.db execute Query:@“select * from t_student;”];

 //根據條件查詢

FMResultSet *resultSet = [self.db executeQuery:@“select * from t_student where id

 //遍歷結果集合   

while ([resultSet  next])

   {

    int idNum = [resultSet intForColumn:@“id”]；

    NSString *name = [resultSet    

    objectForColumn:@“name”];

    int age = [resultSet intForColumn:@“age”];

  }

• 使用FMDataBase類執行數據庫銷毀命令SQLdrop ...

  //如果表格存在 則銷毀
  [self.db executeUpadate:@“drop table if exists t_student;”];

• 使用FMDatabaseQueue類實現多線程操作

在多個線程中同時使用一個FMDatabase實例是不明智的。現在你可以為每 個線程創建一個FMDatabase對象，不要讓多個線程分享同一個實例，他無 法在多個線程中同事使用。否則程序會時不時崩潰或者報告異常。所以，不要 初始化FMDatabase對象，然後在多個線程中使用。這時候，我們就需要使 用FMDatabaseQueue來創建隊列執行事務。

 //1.創建隊列
 FMDatabaseQueue *queue = [FMDatabaseQueue   
 databaseQueueWithPath:aPath];
  __block BOOL whoopsSomethingWrongHappened = true;
 //2.把任務包裝到事務裡
 [queue inTransaction:^(FMDatabase *db, BOOL *rollback) 
   {  
 whoopsSomethingWrongHappened &=  [db     executeUpdate:@“INSERT INTO myTable VALUES (?)”,     [NSNumber numberWith:1]];
whoopsSomethingWrongHappened &= [db
executeUpdata:@“INSERT INTO myTable VALUES (?)”, 
[NSNumber numberWithInt:2]];
whoopsSomethingWrongHappened &= [db  
executeUpdata:@“INSERT INTO myTable VALUES (?)”[NSNumber  
numberWithInt:3]];
//如果有錯誤 返回
if (!whoopsSomethingWrongHappened)
  { 
    *rollback = YES;
      return;
  }
}];

好了，到此為止，相信你已經能夠使用FMDB進行數據持久化了，它的好與壞 只有在不斷地使用過程中才能發現了解。所以，希望大家學會了以後還是要多 寫多練多使用。另外，誠心希望大家多提寶貴意見，或者溝通一些好的想法。^^