FMDB的使用

FMDB介绍

FMDB是一款简洁、易用的封装库。因此，在这里推荐使用第三方框架FMDB，它是对libsqlite3框架的封装，用起来的步骤与SQLite使用类似，并且它对于多线程的并发操作进行了处理，所以是线程安全的。

• 对多线程的并发操作进行处理，所以是线程安全的。
• 以OC的方式封装了SQLite的C语言API，使用起来更加的方便。
• FMDB是轻量级的框架，使用灵活。

---

FMDB导入

• 用cocoapods导入
• 导入libsqlite3.0.tbd库
• 导入头文件#import <FMDB/FMDB.h>

platform :ios, '8.0'
target 'FMDBDemo' do
use_frameworks!
pod 'FMDB'
end

FMDB框架中重要的框架类

• FMDatabase
FMDatabase对象就代表一个单独的SQLite数据库，用来执行SQL语句。
• FMResultSet
  使用FMDatabase执行查询后的结果集。
• FMDatabaseQueue
  用于在多线程中执行多个查询或更新，它是线程安全的。

数据库路径

创建FMDatabase对象时参数为SQLite数据库文件路径。

• 文件路径。该文件路径无需真实存在，如果不存在会自动创建。
• 空字符串@""。表示会在临时目录创建一个空的数据库，当FMDatabase连接关闭时，文件也会被删除。
• NULL。将创建一个内在数据库，同样的，当FMDatabase连接关闭时，数据将会被销毁

NSString *lidDirPath = [NSSearchPathForDirectoriesInDomains(NSLibraryDirectory, NSUserDomainMask, YES) lastObject];
NSString *databasePath = [lidDirPath stringByAppendingPathComponent:@"DatabaseDemo.sqlite"];

---

使用FMDataBase类执行数据库命令SQL

• executeUpdate:

一切不是SELECT命令的命令都视为更新。这包括 CREAT，UPDATE，INSERT，ALTER，BEGIN，COMMIT，DETACH，DELETE，DROP，END，EXPLAIN，VACUUM，REPLACE等。

• executeQuery:

SELECT开头的命令

执行更新返回一个BOOL值。YES表示执行成功，No则表示有错误。你可以调用-lastErrorMessage和-lastErrorCode方法来得到更多信息。

注意:
执行语句不区分大小写。

---

创建数据库

// 根据指定的沙盒路径来创建数据对象，如果路径下的数据库不存在，就创建，如果存在就不创建
self.database = [FMDatabase databaseWithPath:databasePath];
if (self.database != nil) {
    NSLog(@"数据库创建成功!");
} else {
    NSLog(@"数据库创建失败!");
}

创建表

// 所有的数据库SQL语句，都需要数据库打开之后才能操作
if ([self.database open]) {
    NSString *createTableSql = @"create table if not exists User(id integer primary key autoincrement, username text not null, phone text not null, age integer)";
    BOOL result = [self.database executeUpdate:createTableSql];
    if (result) {
        NSLog(@"创建表成功");
    } else {
        NSLog(@"创建表失败");
    }
    // 每次执行完对应SQL之后，要关闭数据库
    [self.database close];
}

创建成功后能在沙盒路径文件夹下看到.sqlite文件

---

插入指令insert

if ([self.database open]) {
    NSString *insertSql = @"insert into User(username, phone, age) values(?, ?, ?)";
    BOOL result = [self.database executeUpdate:insertSql, @"user01", @"110", @(18)];
    if (result) {
        NSLog(@"插入数据成功");
    } else {
        NSLog(@"插入数据失败");
    }
    [self.database close];
}

可以看到数据库插入了一条数据

---

删除指令delete

if ([self.database open]) {
    NSString *deleteSql = @"delete from User where username = ?";
    BOOL result = [self.database executeUpdate:deleteSql, @"user01"];
    if (result) {
        NSLog(@"删除数据成功");
    } else {
        NSLog(@"删除数据失败");
    }
    [self.database close];
}

可以看到数据库对应数据被删除了

---

更新指令update

if ([self.database open]) {
    NSString *updateSql = @"update User set phone = ? where username = ?";
    BOOL result = [self.database executeUpdate:updateSql, @"15823456789", @"user01"];
    if (result) {
        NSLog(@"更新数据成功");
    } else {
        NSLog(@"更新数据失败");
    }
    [self.database close];
}

可以看到数据库对应数据更新了数据

---

查询指令select

if ([self.database open]) {
    NSString *selectSql = @"select * from User";
    FMResultSet *resultSet = [self.database executeQuery:selectSql];
    while ([resultSet next]) {
    NSString *username = [resultSet stringForColumn:@"username"];
    NSString *phone = [resultSet stringForColumn:@"phone"];
    NSInteger age = [resultSet intForColumn:@"age"];
    NSLog(@"username=%@, phone=%@, age=%ld \n", username, phone, age);
    }
    [self.database close];
}

打印结果

2018-02-05 01:22:50.519489+0800 FMDBDemo[2960:227862] username=user01, phone=15823456789, age=18
2018-02-05 01:22:50.519661+0800 FMDBDemo[2960:227862] username=user02, phone=10086, age=20

---

使用FMDatabaseQueue类实现多线程操作

在多个线程中同时使用一个FMDatabase实例是不明智的。现在你可以为每 个线程创建一个FMDatabase对象，不要让多个线程分享同一个实例，他无法在多个线程中同时使用。否则程序会时不时崩溃或者报告异常。所以，不要初始化FMDatabase对象，然后在多个线程中使用。这时候，我们就需要使 用FMDatabaseQueue来创建队列执行事务。

self.databaseQueue = [FMDatabaseQueue databaseQueueWithPath:databasePath];

// // 要执行的SQL语句，要放在Block里执行，用inDatabase不用手动打开和关闭数据库
[self.databaseQueue inDatabase:^(FMDatabase * _Nonnull db) {
    // 创建表，增加，删除，更新，查询 操作
}];

注意block捕捉变量，使用__block BOOL result = NO;