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 代码了。