FMDB的使用

FMDB
Demo

目录

1、FMDB介绍
2、FMDB导入
3、FMDB框架中重要的框架类
3.1、FMDatabase
3.1.1、数据库路径
3.1.2、使用FMDataBase类执行数据库命令SQL
3.1.3、创建数据库
3.1.4、创建表
3.1.5、插入指令insert
3.1.6、删除指令delete
3.1.7、更新指令update
3.2、FMResultSet
3.2.1、查询指令select
3.3、FMDatabaseQueue
3.3.1、使用FMDatabaseQueue类实现多线程操作
4数据库相关文章

1、FMDB介绍

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

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

2、FMDB导入

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

platform :ios, '8.0'
use_frameworks!

target 'FMDB-Demo' do
    pod 'FMDB'
end

3、FMDB框架中重要的框架类

• 3.1 FMDatabase:
  FMDatabase对象就代表一个单独的SQLite数据库，用来执行SQL语句。

• 3.2 FMResultSet:
  使用FMDatabase执行查询后的结果集。

• 3.3 FMDatabaseQueue:
  用于在多线程中执行多个查询或更新，它是线程安全的。

3.1.1、数据库路径

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

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

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

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

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

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

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

3.1.3、创建数据库

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

3.1.4、创建表

// 所有的数据库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文件

image.png

3.1.5、插入指令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];
}

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

image.png

3.1.6、删除指令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];
}

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

image.png

3.1.7、更新指令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];
}

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

image.png

3.2.1、查询指令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

3.3.1、使用FMDatabaseQueue类实现多线程操作

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

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

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

4、数据库相关文章

Mac终端查看sqlite3数据库、表数据等（含sqlite可视化工具下载）

参考文章：
FMDB的使用