FMDB 框架小结

2024-06-06 12:58
文章标签 框架 小结 fmdb

本文主要是介绍FMDB 框架小结,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!

FMDB

FMDB 框架是对 SQLite 数据库 C 语言接口的 Objective-C 封装,即对 sqlite3.h 文件中相关接口的封装。

sqlite3 的使用十分简单,主要是下面两个对象、常用函数的使用:

  • sqlite3
  • sqlite3_stmt
  • sqlite3_open()
  • sqlite3_prepare()
  • sqlite3_bind()
  • sqlite3_step()
  • sqlite3_column()
  • sqlite3_finalize()
  • sqlite3_close()
  • sqlite3_exec()

FMDB 框架基本也就涉及这几个函数。

typedef struct sqlite3 sqlite3;

每一个打开的 SQLite 数据库都由一个透明的结构体 sqlite3 来表示,所以可以将 sqlite3 指针看作一个对象。

typedef struct sqlite3_stmt sqlite3_stmt;

sqlite3_stmt 表示一个编译为二进制形式的 SQL 语句,可以进一步执行了。

FMStatement

FMStatement 是对 sqlite3_stmt 的封装,其成员变量如下,其中 _statement 指针就指向了 sqlite3_stmt 结构体。

@interface FMStatement : NSObject {void *_statement;NSString *_query;long _useCount;BOOL _inUse;
}

在框架的具体使用过程中,我们并不需要关心该类的使用。

FMDatabase

FMDatabase 的使用大致遵循下面几个步骤:

  1. 提供一个数据库文件路径,创建一个 FMDatabase 类实例对象。此时,数据库可能并不存在,这里只是初始化了一些属性。

  2. 打开数据库连接,这里可以调用 openopenWithFlags:openWithFlags:vfs: 方法,来实现数据库的连接,此时可能会创建数据库,如果其不存在的话。

  3. 修改数据库,该类中提供了多个方法来对数据库进行更新,方法名以 executeUpdate 字符串开头 ,除了 executeUpdateWithFormat: 方法可以直接使用占位符进行参数的传递外,其他方法都是通过使用 ? 占位符,并同时传递集合参数的方式来构造 SQLite 命令的。但是,最终都是要使用 sqlite3_bind_* 函数进行参数绑定的。

  4. 查询数据库,查询数据库的方法以 executeQuery 字符串开头,并且同修改数据库的方法类似 executeQueryWithFormat: 方法也是可以直接使用各种占位符的,而其他方法都是用 ? 作为占位符的。

  5. 关闭数据库,该类的实例对象在释放时,会自动去关闭当前打开的数据库,当然如有需要,也可以调用 close 方法自行关闭。

FMResultSet

FMResultSet 是使用 FMDatabase 进行数据库查询操作后对查询结果的封装类。这个类十分的简单,实际就是对 sqlite3_step() 函数的封装。

在使用过程中,需要调用 nextnextWithError: 方法获取下一个查询结果,在 nextWithError: 方法中实际就是执行了 sqlite3_step() 函数来获取查询结果集合中的一条记录。而后,根据列名或列索引来获取具体某个字段的值。

实际,在具体的方法实现中,都是通过索引来获取指定字段的值,这是因为最终获取值的 SQLite 接口 sqlite3_column_*() 函数的参数是列的索引值(从 0 开始计算)。

除了通常使用的 stringForColumn: 方法来获取字符串值外,还可以使用 objectForColumn: 方法获取诸如 NSNumberNSDataObjective-C 对象,并且注意如果值为 nil 那么返回的是 NSNull 实例。

另外,该类中还实现了下面两个方法:

- (id _Nullable)objectAtIndexedSubscript:(int)columnIdx;
- (id _Nullable)objectForKeyedSubscript:(NSString *)columnName;

所以在获取具体字段的值时,是支持下标运算的。

该类中还提供了一个方法来支持 KVC 编程,如果你的查询记录的各个字段完全是某个类的属性名称,或者你就是这样设计的,那么使用下面这个函数,将会直接把查询记录中的各个字段的结果赋值给所传递的对象的相应属性中。

- (void)kvcMagic:(id)object;

除了各个取值方法,还有两个属性可以了解一下,如下:

@property (readonly) NSMutableDictionary *columnNameToIndexMap;@property (nonatomic, readonly, nullable) NSDictionary *resultDictionary;
  • columnNameToIndexMap 该属性保存的是查询结果的字段名所对应的索引值,通过字段名来获取值时,就是使用该属性来获取相应字段名的索引,进而获取具体值。
  • resultDictionary 该属性是将当前的记录转换为一个字典,键是各个字段名,值就是对应的具体值。

FMDatabaseQueue

在多线程中直接使用 FMDatabse 对象操作同一个数据库文件是不安全的,所以 FMDB 第三方库提供了 DMDatabaseQueue 来方便在多线程中操作同一个数据库。

在具体的实现中,该类通过创建一个串行队列以及一个 FMDatabase 实例来同步不同线程中对数据库的操作。

@interface FMDatabaseQueue () {dispatch_queue_t    _queue;FMDatabase          *_db;
}
@end

如,在主线程中执行下面的测试函数。

let queue = FMDatabaseQueue.init(path: "")func test() {print("1-  ",Thread.current)DispatchQueue.init(label: "testQueue1").async {print("2-  ",Thread.current)self.queue.inDatabase() {database inprint("2--  ",Thread.current)try! database.executeUpdate("create table if not exists person (studentNo integer primary key,age interger,sex char) ", values: nil)print("2---  ",Thread.current)}print("2----  ",Thread.current)}DispatchQueue.init(label: "testQueue2").async {print("3-  ",Thread.current)self.queue.inDatabase({ (database) inprint("3--  ",Thread.current)database.executeUpdate("insert into person (age,sex) values(?,?)", withArgumentsIn: [4,"男"])print("3---  ",Thread.current)})print("3----  ",Thread.current)}print("1--  ",Thread.current)
}

得到的输出如下:

1-   <NSThread: 0x600003968000>{number = 1, name = main}
1--   <NSThread: 0x600003968000>{number = 1, name = main}
2-   <NSThread: 0x6000039e3000>{number = 5, name = (null)}
3-   <NSThread: 0x60000391d500>{number = 6, name = (null)}
2--   <NSThread: 0x6000039e3000>{number = 5, name = (null)}
2---   <NSThread: 0x6000039e3000>{number = 5, name = (null)}
2----   <NSThread: 0x6000039e3000>{number = 5, name = (null)}
3--   <NSThread: 0x60000391d500>{number = 6, name = (null)}
3---   <NSThread: 0x60000391d500>{number = 6, name = (null)}
3----   <NSThread: 0x60000391d500>{number = 6, name = (null)}

当然,这只是一种结果,虽然输出的结果是不确定的,但是可以发现,2---- 总是在 3-- 之前打印出来。即,每一个数据库操作任务都封装在代码块中,并提交到 FMDatabaseQueue 实例中的串行队列中,而且当前任务会被阻塞,直到数据库操作任务执行完毕。

FMDatabasePool

如果对于一个数据库,只涉及到对其的大量读取,而不涉及其他修改等操作时,可以使用该类。这个数据库池的实现十分简单,主要是通过一个串行队列和两个可变数组实现的。

@interface FMDatabasePool () {dispatch_queue_t    _lockQueue;NSMutableArray      *_databaseInPool;NSMutableArray      *_databaseOutPool;
}

该类中针对同一个数据库文件可以最多创建 maximumNumberOfDatabasesToCreateFMDatabase 实例对象用来操作数据库。应该注意的是,该类使用 _lockQueue 队列来保证线程池的操作是安全的,但是数据库的操作并非是线程安全的。所以,不应该使用该类去对数据库进行非只读的操作。

对于两个数组,_databaseInPool 保存着空闲的 FMDatabase 实例对象,当需要操作数据库时,从该数组中取出实例,而后将其添加到 _databaseOutPool 数组中,因为该数组保存所有正在使用的 FMDatabase 实例对象,使用完毕后再归还到 _databaseInPool 数组中,这个过程是线程安全的。

该类还定义了两个非正式协议方法,用来询问是否向池中新增对象,以及成功新增对象后需要执行什么额外任务。

@interface NSObject (FMDatabasePoolDelegate)- (BOOL)databasePool:(FMDatabasePool*)pool shouldAddDatabaseToPool:(FMDatabase*)database;
- (void)databasePool:(FMDatabasePool*)pool didAddDatabase:(FMDatabase*)database;@end

当然,如果一个 FMDatabase 实例对象已经在池中了,那么便不会再执行 databasePool:didAddDatabase: 方法了,但是你可以通过 databasePool:shouldAddDatabaseToPool: 方法来将其关闭。

这篇关于FMDB 框架小结的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!



http://www.chinasem.cn/article/1036174

相关文章

Java对异常的认识与异常的处理小结

《Java对异常的认识与异常的处理小结》Java程序在运行时可能出现的错误或非正常情况称为异常,下面给大家介绍Java对异常的认识与异常的处理,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参... 目录一、认识异常与异常类型。二、异常的处理三、总结 一、认识异常与异常类型。(1)简单定义-什么是

Python函数返回多个值的多种方法小结

《Python函数返回多个值的多种方法小结》在Python中,函数通常用于封装一段代码,使其可以重复调用,有时,我们希望一个函数能够返回多个值,Python提供了几种不同的方法来实现这一点,需要的朋友... 目录一、使用元组(Tuple):二、使用列表(list)三、使用字典(Dictionary)四、 使

Python程序的文件头部声明小结

《Python程序的文件头部声明小结》在Python文件的顶部声明编码通常是必须的,尤其是在处理非ASCII字符时,下面就来介绍一下两种头部文件声明,具有一定的参考价值,感兴趣的可以了解一下... 目录一、# coding=utf-8二、#!/usr/bin/env python三、运行Python程序四、

Python中合并列表(list)的六种方法小结

《Python中合并列表(list)的六种方法小结》本文主要介绍了Python中合并列表(list)的六种方法小结,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋... 目录一、直接用 + 合并列表二、用 extend() js方法三、用 zip() 函数交叉合并四、用

Spring Boot中的YML配置列表及应用小结

《SpringBoot中的YML配置列表及应用小结》在SpringBoot中使用YAML进行列表的配置不仅简洁明了,还能提高代码的可读性和可维护性,:本文主要介绍SpringBoot中的YML配... 目录YAML列表的基础语法在Spring Boot中的应用从YAML读取列表列表中的复杂对象其他注意事项总

C++ HTTP框架推荐(特点及优势)

《C++HTTP框架推荐(特点及优势)》:本文主要介绍C++HTTP框架推荐的相关资料,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友参考下吧... 目录1. Crow2. Drogon3. Pistache4. cpp-httplib5. Beast (Boos

CSS 样式表的四种应用方式及css注释的应用小结

《CSS样式表的四种应用方式及css注释的应用小结》:本文主要介绍了CSS样式表的四种应用方式及css注释的应用小结,本文通过实例代码给大家介绍的非常详细,详细内容请阅读本文,希望能对你有所帮助... 一、外部 css(推荐方式)定义:将 CSS 代码保存为独立的 .css 文件,通过 <link> 标签

SpringBoot基础框架详解

《SpringBoot基础框架详解》SpringBoot开发目的是为了简化Spring应用的创建、运行、调试和部署等,使用SpringBoot可以不用或者只需要很少的Spring配置就可以让企业项目快... 目录SpringBoot基础 – 框架介绍1.SpringBoot介绍1.1 概述1.2 核心功能2

CSS引入方式和选择符的讲解和运用小结

《CSS引入方式和选择符的讲解和运用小结》CSS即层叠样式表,是一种用于描述网页文档(如HTML或XML)外观和格式的样式表语言,它主要用于将网页内容的呈现(外观)和结构(内容)分离,从而实现... 目录一、前言二、css 是什么三、CSS 引入方式1、行内样式2、内部样式表3、链入外部样式表四、CSS 选

$在R语言中的作用示例小结

《$在R语言中的作用示例小结》在R语言中,$是一个非常重要的操作符,主要用于访问对象的成员或组件,它的用途非常广泛,不仅限于数据框(dataframe),还可以用于列表(list)、环境(enviro... 目录1. 访问数据框(data frame)中的列2. 访问列表(list)中的元素3. 访问jav