FMDB的简单使用

1、什么是FMDB？

• FMDB是iOS平台的SQLite数据库框架
• FMDB以OC的方式封装了SQLite的C语言API。
• 无论项目中使用 ARC 还是 MRC，对 FMDB 都没有任何影响，FMDB 会在编译项目时自动匹配。

2、FMDB主要的类。

2.1、FMDatabase

一个FMDatabase对象就代表一个单独的SQLite数据库，用来执行SQL语句。通过指定SQLite数据库文件路径来创建FMDatabase对象。

在FMDB中，一般只要不是以 SELECT 开头的 SQL 语句，都是更新语句，包括CREATE，UPDATE，INSERT，ALTER，COMMIT，BEGIN，DETACH，DROP，END，EXPLAIN，VACUUM，REPLACE等。使用executeUpdate:方法执行更新：

• - (BOOL)executeUpdate:(NSString*)sql, ...;

• - (BOOL)executeUpdateWithFormat:(NSString*)format, ...;

• - (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments;

执行更新语句后会返回一个 BOOL 值，返回YES表示执行更新语句成功，返回NO表示出现错误，可以通过调用 -lastErrorMessage 和 -lastErrorCode 方法获取更多错误信息。

创库创表：

•   // 获取数据库文件路径
    NSString *path = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"test.sqlite"];
    // 创建数据库
    FMDatabase *db = [FMDatabase databaseWithPath:path];
    self.db = db;
    if (db.open) {// 打开数据库，数据库必须是打开状态，才能与之交互。如果没有足够的资源和权限来打开或者创建数据库，数据库会打开失败。
        NSLog(@"打开成功");
        // 创表
        BOOL result = [db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL)"];
       if (result) {
           NSLog(@"创表成功");
       } else {
           NSLog(@"创表失败:%@", [self.db lastErrorMessage]);
       }
   } else {
       NSLog(@"打开失败");
   }

添加数据：

•  // executeUpdate:不确定的参数用？来占位，所有参数都必须是对象。
   //    BOOL result = [self.db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?)", @"jick", @(arc4random_uniform(20))];
   // executeUpdateWithFormat:不确定的参数用％@、％f、％d、％u等来占位。
   BOOL result = [self.db executeUpdateWithFormat:@"INSERT INTO t_person (name, age) VALUES (%@, %d)", @"jick", arc4random_uniform()];
   if (result) {
       NSLog(@"添加成功");
   } else {
       NSLog(@"添加失败:%@", [self.db lastErrorMessage]);
   }

删除、更新数据：同创表、添加数据方法相同，只需修改SQL语句就行了。

• 关闭数据库：  [self.db close];

文件路径有三种情况：

• 具体文件路径：如果不存在会自动创建。

• 空字符串@""：会在临时目录创建一个空的数据库，当FMDatabase连接关闭时，数据库文件也被销毁。

• nil：会在内存中创建一个临时数据库，当FMDatabase连接关闭时，数据库会被销毁。

2.2、FMResultSet。

使用FMDatabase执行查询后的结果集:

• - (FMResultSet *)executeQuery:(NSString*)sql, ...;

• - (FMResultSet *)executeQueryWithFormat:(NSString*)format, ...;

• - (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments;

执行查询操作后，如果成功会返回一个FMResultSet对象，反之会返回nil。通过 -lastErrorMessage 和 -lastErrorCode 方法可以确定查询失败原因。

为了遍历查询结果，需要while()循环，然后逐条记录查看。在 FMDB 中，可以通过下面的简单方式实现：

•  // 执行查询语句
   FMResultSet *result = [self.db executeQuery:@"SELECT * FROM t_person WHERE age < 15"];
   // 遍历结果，它是基于列的位置来查询数据。
   while (result.next) {
       int ID = [result intForColumn:@"id"];
       NSString *name = [result stringForColumn:@"name"];
       int age = [result intForColumn:@"age"];
       NSLog(@"id = %d, name = %@, age = %d", ID, name, age);
   }

• 关闭数据库：  [self.db close];

2.3、FMDatabaseQueue。

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

• FMDatabaseQueue的创建：

•  数据库文件路径
   NSString *path = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES).lastObject stringByAppendingPathComponent:@"test.sqlite"];
   // 创建数据库
   FMDatabaseQueue *dbq = [FMDatabaseQueue databaseQueueWithPath:path];
   self.dbq = dbq;
   // 打开数据库
   [dbq inDatabase:^(FMDatabase *db) {
       BOOL result = [db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL)"]; // 创表
       if (result) {
           NSLog(@"创表成功");
       } else {
           NSLog(@"创表失败:%@", [db lastErrorMessage]);
       }
   }];

• 添加数据：更新、删除和添加数据的方法类似。

   [self.dbq inDatabase:^(FMDatabase *db) {
       BOOL result = [db executeUpdateWithFormat:@"INSERT INTO t_person (name, age) VALUES (%@, %d)", @"jick", arc4random_uniform()];
       if (result) {
           NSLog(@"添加成功");
       } else {
           NSLog(@"添加失败");
       }
   }];

• 查询数据：

   [self.dbq inDatabase:^(FMDatabase *db) {
       // 执行查询语句
       FMResultSet *result = [db executeQuery:@"SELECT * FROM t_person WHERE age < 15"];
       // 遍历结果
       while (result.next) {
           int ID = [result intForColumn:@"id"];
           NSString *name = [result stringForColumn:@"name"];
           int age = [result intForColumn:@"age"];
           NSLog(@"id = %d, name = %@, age = %d", ID, name, age);
       }
   }];

• 关闭数据库： [self.dbq close];

3、FMDB的多语句、多事务处理。

3.1、多语句的批处理。

通过-executeStatements:withResultBlock:方法在一个字符串中执行多语句:

• 创建多张表并添加数据：

•  NSString *sql = [NSString stringWithFormat:
                    @"CREATE TABLE IF NOT EXISTS t_person1 (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"
                    "CREATE TABLE IF NOT EXISTS t_person2 (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"
                    "CREATE TABLE IF NOT EXISTS t_person3 (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"
                    "INSERT INTO t_person1 (name, age) VALUES (%@, %d);"
                    "INSERT INTO t_person1 (name, age) VALUES (%@, %d);"
                    "INSERT INTO t_person2 (name, age) VALUES (%@, %d);"
                    "INSERT INTO t_person2 (name, age) VALUES (%@, %d);"
                    "INSERT INTO t_person3 (name, age) VALUES (%@, %d);"
                    "INSERT INTO t_person3 (name, age) VALUES (%@, %d);",
                    @"'jick'", , @"'tom'", , @"'rose'", , @"'jim'", , @"'hank'", , @"'jone'", ];
   BOOL result = [self.db executeStatements:sql];
   if (result) {
       NSLog(@"创表并添加数据成功");
   } else {
       NSLog(@"创表或添加数据失败:%@", [self.db lastErrorMessage]);
   }

• 查询多张表的多个字段值：

   NSString *sql = @"SELECT * FROM t_person1 WHERE age < 30;"
                   "SELECT * FROM t_person2 WHERE age < 30;"
                   "SELECT * FROM t_person3 WHERE age < 30;";
   [self.db executeStatements:sql withResultBlock:^int(NSDictionary *resultsDictionary) {
       int ID = [resultsDictionary[@"id"] intValue];
       NSString *name = resultsDictionary[@"name"];
       int age = [resultsDictionary[@"age"] intValue];
       NSLog(@"name = %@, id = %d, age = %d", name, ID, age);
       return ;
   }];

3.2、FMDataba事务处理。

在FMDatabase/FMDatabaseQueue中通过begin/commit语句来开始和提交事务。

•  //    [self.db executeUpdate:@"begin exclusive transaction"]; // 用SQL语句的方式开启事务
   [self.db beginTransaction]; // 开启事务
   [self.db executeUpdateWithFormat:@"INSERT INTO t_person1 (name, age) VALUES (%@, %d);",@"'jick1'", ];
   [self.db executeUpdateWithFormat:@"INSERT INTO t_person2 (name, age) VALUES (%@, %d);",@"'jick1'", ];
   //    [self.db executeUpdate:@"rollback transaction"]; // 用SQL语句的方式中途回滚
   //    [self.db rollback]; // 中途回滚。
   [self.db executeUpdateWithFormat:@"INSERT INTO t_person3 (name, age) VALUES (%@, %d);",@"'jick1'", ];
   //    [self.db executeUpdate:@"commit transaction"]; // 用SQL语句的方式提交事务
   [self.db commit]; // 提交事务

在FMDatabaseQueue中通过调用方法来提交事务。

•  [self.dbq inTransaction:^(FMDatabase *db, BOOL *rollback) {
       [db executeUpdateWithFormat:@"INSERT INTO t_person1 (name, age) VALUES (%@, %d);",@"'jick1'", ];
       [db executeUpdateWithFormat:@"INSERT INTO t_person2 (name, age) VALUES (%@, %d);",@"'jick1'", ];
       // *rollback = YES; // 中途回滚
       [db executeUpdateWithFormat:@"INSERT INTO t_person3 (name, age) VALUES (%@, %d);",@"'jick1'", ];
   }];

4、在Swift中使用FMDB。

在Swift项目中使用 FMDB，需要做以下步骤：

• 将 FMDB 的 .m 和 .h 全部文件拖进你的项目。
• 如果 Xcode 提示创建桥接文件，需要点击创建。如果没有提示，且项目中也没有桥接文件，需要手动添加。
• 在桥接文件中，添加这行代码：#import "FMDB.h"
• 可以从 "src/extra/Swift Extension" 文件夹中拷贝 FMDatabaseVariadic.swift 文件到项目中，就可以使用 executeUpdate 和 executeQuery 多参数了。

做完上述几步，就可以使用 FMDatabase 写 Swift 代码了。