笔记-FMDB

简介

SQLite

一个轻量级的关系型数据库，SQLite不区分大小写，可是也有注意的地方，GLOB和glob具备不一样做用。另外有5中基本数据类型text、integer、real、boolean、blob

SQLite的使用方法

• 加入libsqlite3.tbd的依赖库
• 在文件中引用#improt<sqlite3.h>头文件
• 打开数据库->建立表->对数据表进行操做->关闭数据库

FMDB

FMDB是iOS平台的SQLite数据库框架，以OC的方式封装了SQLite的C语言API

FMDB经常使用的三个类：
FMDataBase：一个FMDatabase对象就表明一个单独的SQLite数据库
FMResultSet： 使用FMDatabase执行查询后的结果集合
FMDatabaseQueue： 用于多线程中执行多个查询或更新，它是线程安全的

FMDB的建立和使用方法

• 下载FMDB（GitHub），而后拖入工程中，也支持pod导入
• 在工程中添加libsqlite3.tbd的依赖库
• 引入头文件#import "FMDB.h"
• 代码的实现：建立库路径->建立数据库->打开数据库->建立表->对数据库进行操做->关闭数据库

建立库路径

iOS本地优化存储的数据保存在沙盒中，而且每一个应用的沙盒是相对独立的，每一个应用的沙盒文件结构都是相同的，以下图所示：

Documents：iTunes会备份改目录，通常用来存储须要持久化的数据。

Library/Caches：缓存，iTunes不会备份该目录。内存不足时会被清除，应用没有运行时，可能会被清除。通常存储体积大，不须要备份的非重要数据。

Library/Preference：iTunes会备份该目录，能够用来存储一些偏好设置。

tmp：iTunes不会备份这个目录，用来保存临时数据，应用退出时会清除该目录下的数据。

建立路径

上面的方法有三个参数，说明一下：

NSDocumentDirectory： 第一个参数表明要查找哪一个文件，是一个枚举，为了直接找到沙盒中的Documents目录，咱们通常用NSDocumentDirectory。

NSUserDomainMask： 也是一个枚举，表示搜索的范围限制于当前应用的沙盒目录。

YES： 第三个参数是一个BOOL值，iOS中主目录的全写形式是/User/userName，这个参数填YES就表示全写，填NO就是“~”，通常使用YES。

经过制定SQLite数据库文件的路径来建立一个FMDatabase，路径能够是一下几种方式中的任何一种

• 完整的路径，若是路径不存在，会自动建立。
• 空字符串@""，会自动在缓存区建立一个空的数据库，FMDatabase链接关闭时，数据库会被自动删除。
• 路径为NULL，会在内存中建立一个数据库，一样的，在FMDatabase链接关闭时，数据库会被自动删除。

打开数据库，建立表

使用open语句打开数据库，打开成功返回YES，打开失败返回NO

执行数据库操做

通常状况下，咱们最经常使用的两个方法

db executeQuery:(NSString*)sql, ...
db executeUpdate:(NSString*)sql, ...
复制代码

• 更新（create、drop、insert、update、delete、alter、commit、begin、detach、explain、vacuum、replace等）
• 执行（select）

关闭数据库

[db close];
复制代码

FMDatabaseQueue

FMDatabase是线程不安全的，当FMDB数据存储想要使用多线程的时候，FMDatabaseQueue就可以用上了。
初始化FMDatabaseQueue的方法与FMDatabase相似

FMDatabaseQueue打开和关闭数据库

在初始化的时候FMDatabaseQueue已经将打开和关闭数据库封装好了。因此在操做数据库的时候不须要单独调用FMDatabase的open与close方法。

经过网上资料的查找有关其余API的解读，这里说一下

更新

- (BOOL)executeUpdate:(NSString*)sql, ...;
- (BOOL)executeUpdateWithFormat:(NSString *)format, ... NS_FORMAT_FUNCTION(1,2);
- (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments;
- (BOOL)executeUpdate:(NSString*)sql values:(NSArray * _Nullable)values error:(NSError * _Nullable __autoreleasing *)error;
- (BOOL)executeUpdate:(NSString*)sql withParameterDictionary:(NSDictionary *)arguments;
- (BOOL)executeUpdate:(NSString*)sql withVAList: (va_list)args;
复制代码

查询

- (FMResultSet * _Nullable)executeQuery:(NSString*)sql, ...;
- (FMResultSet * _Nullable)executeQueryWithFormat:(NSString*)format, ... NS_FORMAT_FUNCTION(1,2);
- (FMResultSet * _Nullable)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments;
- (FMResultSet * _Nullable)executeQuery:(NSString *)sql values:(NSArray * _Nullable)values error:(NSError * _Nullable __autoreleasing *)error;
- (FMResultSet * _Nullable)executeQuery:(NSString *)sql withParameterDictionary:(NSDictionary * _Nullable)arguments;
- (FMResultSet * _Nullable)executeQuery:(NSString *)sql withVAList:(va_list)args;
复制代码

方法解读：

一、若是须要插入基础数据类型，要么本身作一下转换，要么调用如下方法
- (FMResultSet * _Nullable)executeQueryWithFormat:(NSString*)format, ... NS_FORMAT_FUNCTION(1,2);

[_dataBaseQueue inDatabase:^(FMDatabase * _Nonnull db) {
    [db executeUpdateWithFormat:@"INSERT INTO usertable VALUES (%d, %@ , %d)", 1, @"lizhiqiang", 25];
}];


二、这个没什么可说的，数组参数，直接上代码
- (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments;

[_dataBaseQueue inDatabase:^(FMDatabase * _Nonnull db) {
    [db executeUpdate:@"INSERT INTO usertable VALUES (?, ? , ?)" withArgumentsInArray:@[@2, @"yanghuixue", @26]];
}];


三、比方法2多了error指针参数，记录更新失败
- (BOOL)executeUpdate:(NSString*)sql values:(NSArray * _Nullable)values error:(NSError * _Nullable __autoreleasing *)error;


四、注意，这个mark一下，参数为字典，写法变了，而且插入字段必须与字典key相对应
- (BOOL)executeUpdate:(NSString*)sql withParameterDictionary:(NSDictionary *)arguments;

NSDictionary *testDict = @{
                           @"id" : @14,
                           @"name" : @"ly",
                           @"age" : @15
                           };
[_dataBaseQueue inDatabase:^(FMDatabase * _Nonnull db) {
    [db executeUpdate:@"INSERT INTO usertable VALUES(:id, :name, :age)" withParameterDictionary:testDict];
}];


五、va_list是C语言中解决变参问题的一组宏
- (BOOL)executeUpdate:(NSString*)sql withVAList: (va_list)args;
复制代码

批处理：能够经过调用executeStatements方法，一次执行多个sql语句

- (BOOL)executeStatements:(NSString *)sql;
- (BOOL)executeStatements:(NSString *)sql withResultBlock:(__attribute__((noescape)) FMDBExecuteStatementsCallbackBlock _Nullable)block;

例：
NSString *creatSqlString = @"CREATE TABLE IF NOT EXISTS grouptable(id INTEGER, gcid VARCHAR(64), gcname VARCHAR(64));"
@"CREATE TABLE IF NOT EXISTS usertable(id INTEGER, name VARCHAT(1024), age INTEGER)";

[_dataBaseQueue inDatabase:^(FMDatabase *db) {
    [db executeStatements:creatSqlString];
}];
复制代码

事务

事务（Transaction）是不可分割的一个总体操做，要么都执行，要么都不执行。

事务里有回滚操做，当一个总体事务在执行的时候，中间任何一个环节出现问题，则执行回滚，而后整个事务中的全部操做将无效。

FMDatabase使用事务的方法：

FMDatabaseQueue使用事务的方法：

关于SQLite的其余知识点的总结点击这里前往

参考文献：
FMDB进阶
FMDB理论和实践
最全iOS数据存储方法介绍