笔记-FMDB详解

013.jpg

简介

SQLite

一个轻量级的关系型数据库,SQLite不区分大小写,但是也有注意的地方,GLOBglob具有不同作用。另外有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本地优化存储的数据保存在沙盒中,并且每个应用的沙盒是相对独立的,每个应用的沙盒文件结构都是相同的,如下图所示:


image

Documents:iTunes会备份改目录,一般用来存储需要持久化的数据。

Library/Caches:缓存,iTunes不会备份该目录。内存不足时会被清除,应用没有运行时,可能会被清除。一般存储体积大,不需要备份的非重要数据。

Library/Preference:iTunes会备份该目录,可以用来存储一些偏好设置。

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

创建路径


image

上面的方法有三个参数,说明一下:

NSDocumentDirectory: 第一个参数代表要查找哪个文件,是一个枚举,为了直接找到沙盒中的Documents目录,我们一般用NSDocumentDirectory。

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

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

通过制定SQLite数据库文件的路径来创建一个FMDatabase,路径可以是一下几种方式中的任何一种

  • 完整的路径,如果路径不存在,会自动创建。
  • 空字符串@"",会自动在缓存区创建一个空的数据库,FMDatabase连接关闭时,数据库会被自动删除。
  • 路径为NULL,会在内存中创建一个数据库,同样的,在FMDatabase连接关闭时,数据库会被自动删除。

打开数据库,创建表

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

image

执行数据库操作

一般情况下,我们最常用的两个方法

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类似

image

FMDatabaseQueue打开和关闭数据库

在初始化的时候FMDatabaseQueue已经将打开和关闭数据库封装好了。所以在操作数据库的时候不需要单独调用FMDatabaseopenclose方法。

通过网上资料的查找有关其他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;

方法解读:

1、如果需要插入基础数据类型,要么自己做一下转换,要么调用以下方法
- (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];
}];


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

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


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


4、注意,这个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];
}];


5、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使用事务的方法:

image

FMDatabaseQueue使用事务的方法:

image

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

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

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 199,711评论 5 468
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 83,932评论 2 376
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 146,770评论 0 330
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 53,799评论 1 271
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 62,697评论 5 359
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,069评论 1 276
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,535评论 3 390
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,200评论 0 254
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,353评论 1 294
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,290评论 2 317
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,331评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,020评论 3 315
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,610评论 3 303
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,694评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 30,927评论 1 255
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,330评论 2 346
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 41,904评论 2 341

推荐阅读更多精彩内容