FMDB有FMDatabase、FMDatabaseQueue、FMResultSet这三个重量级的类。
- FMDatabase
用来表示sqlite3数据库对象。 - FMDatabaseQueue
用来执行线程安全的多线程数据库操作。 - FMResultSet
数据库对象根据sql语句进行操作后返回的结果集对象。
笔者对于FMDB源码的探究首先从这三个类入手，由于FMDatabaseQueue引用到了FMDatabase，而FMDatabase又引用到了FMResultSet。所以笔者决定通过FMResultSet -> FMDatabase -> FMDatabaseQueue这样的顺序来解读这三个类。
FMDB中用到的宏
在解读源码之前，我们先来看一下FMDB中常用到的一些宏。
- NS_ASSUME_NONNULL_BEGIN&NS_ASSUME_NONNULL_END
在代码中，包含在这两个宏中间的属性、方法均会被加上一个nonnull的标记。如果想要其中的属性或方法不受此约束，则在对应的属性中加入nullable即可
我们可以点击看到这两条宏所定义的语句为
#ifndef NS_ASSUME_NONNULL_BEGIN
#define NS_ASSUME_NONNULL_BEGIN _Pragma("clang assume_nonnull begin")
#endif
#ifndef NS_ASSUME_NONNULL_END
#define NS_ASSUME_NONNULL_END _Pragma("clang assume_nonnull end")
#endif
_Pragma看上去是不是很熟悉，我们经常在代码中写
#pragma mark - 自定义字符串
这是C++中的杂注指令，关于这点，可以看看这里。
这意味着，我们这样写也是有效的
#pragma clang assume_nonnull begin
#pragma clang assume_nonnull end
- FMDB_SQLITE_STANDALONE
这个宏是在FMDB中的podspec中定义的
s.subspec 'standalone' do |ss|
ss.xcconfig = { 'OTHER_CFLAGS' => '$(inherited) -DFMDB_SQLITE_STANDALONE' }
ss.dependency 'sqlite3'
ss.source_files = 'src/fmdb/FM*.{h,m}'
ss.exclude_files = 'src/fmdb.m'
end
目前FMDB中设定的默认子文件夹是'standard'，并不是standalone或者standalone-fts。所以这个宏在工程中都返回NO。
- OS_OBJECT_USE_OBJC
这个宏在FMDB中用于
#if OS_OBJECT_USE_OBJC
#define FMDBDispatchQueueRelease(__v)
#else
#define FMDBDispatchQueueRelease(__v) (dispatch_release(__v));
#endif
OS_OBJECT_USE_OBJC是针对过去iOS 6.0以下版本的GCD并不具备ARC所产生的。所以当OS_OBJECT_USE_OBJC返回0时，GCD需要使用dispatch_release()来释放内存。
- NS_RETURNS_NOT_RETAINED
这个宏用于标注带返回值的方法，并且还有一个兄弟叫做NS_RETURNS_RETAINED。在FMDB中只有2个方法标注了这个宏，并且都在注释中写上了Warning。
- (NSData * _Nullable)dataNoCopyForColumnIndex:(int)columnIdx NS_RETURNS_NOT_RETAINED;
- (NSData * _Nullable)dataNoCopyForColumnIndex:(int)columnIdx NS_RETURNS_NOT_RETAINED;
NS_RETURNS_NOT_RETAINED表示这个方法返回的对象，不需要被release，而NS_RETURNS_RETAINED则表示方法所返回的对象需要被release。
最后在提一下__has_feature这个方法，在Clang中是这么解释的
HasFeature - Return true if we recognize and implement the feature specified by the identifier as a standard language feature.
即为：如果我们识别并实现标识符指定的功能作为标准语言功能，则返回true（google翻译,doge）。
在Clang中它定义了非常多的关键词，有兴趣的朋友可以去看看PPMacroExpansion.cpp,从1094行开始。
再贴一下FMDB中所使用的Sqlite3错误码
#define SQLITE_OK 0 /* 成功 | Successful result */
/* 错误码开始 */
#define SQLITE_ERROR 1 /* SQL错误 或 丢失数据库 | SQL error or missing database */
#define SQLITE_INTERNAL 2 /* SQLite 内部逻辑错误 | Internal logic error in SQLite */
#define SQLITE_PERM 3 /* 拒绝访问 | Access permission denied */
#define SQLITE_ABORT 4 /* 回调函数请求取消操作 | Callback routine requested an abort */
#define SQLITE_BUSY 5 /* 数据库文件被锁定 | The database file is locked */
#define SQLITE_LOCKED 6 /* 数据库中的一个表被锁定 | A table in the database is locked */
#define SQLITE_NOMEM 7 /* 某次 malloc() 函数调用失败 | A malloc() failed */
#define SQLITE_READONLY 8 /* 尝试写入一个只读数据库 | Attempt to write a readonly database */
#define SQLITE_INTERRUPT 9 /* 操作被 sqlite3_interupt() 函数中断 | Operation terminated by sqlite3_interrupt() */
#define SQLITE_IOERR 10 /* 发生某些磁盘 I/O 错误 | Some kind of disk I/O error occurred */
#define SQLITE_CORRUPT 11 /* 数据库磁盘映像不正确 | The database disk image is malformed */
#define SQLITE_NOTFOUND 12 /* sqlite3_file_control() 中出现未知操作数 | Unknown opcode in sqlite3_file_control() */
#define SQLITE_FULL 13 /* 因为数据库满导致插入失败 | Insertion failed because database is full */
#define SQLITE_CANTOPEN 14 /* 无法打开数据库文件 | Unable to open the database file */
#define SQLITE_PROTOCOL 15 /* 数据库锁定协议错误 | Database lock protocol error */
#define SQLITE_EMPTY 16 /* 数据库为空 | Database is empty */
#define SQLITE_SCHEMA 17 /* 数据结构发生改变 | The database schema changed */
#define SQLITE_TOOBIG 18 /* 字符串或二进制数据超过大小限制 | String or BLOB exceeds size limit */
#define SQLITE_CONSTRAINT 19 /* 由于约束违例而取消 | Abort due to constraint violation */
#define SQLITE_MISMATCH 20 /* 数据类型不匹配 | Data type mismatch */
#define SQLITE_MISUSE 21 /* 不正确的库使用 | Library used incorrectly */
#define SQLITE_NOLFS 22 /* 使用了操作系统不支持的功能 | Uses OS features not supported on host */
#define SQLITE_AUTH 23 /* 授权失败 | Authorization denied */
#define SQLITE_FORMAT 24 /* 附加数据库格式错误 | Auxiliary database format error */
#define SQLITE_RANGE 25 /* 传递给sqlite3_bind()的第二个参数超出范围 | 2nd parameter to sqlite3_bind out of range */
#define SQLITE_NOTADB 26 /* 被打开的文件不是一个数据库文件 | File opened that is not a database file */
#define SQLITE_ROW 100 /* sqlite3_step() 已经产生一个行结果 | sqlite3_step() has another row ready */
#define SQLITE_DONE 101 /* sqlite3_step() 完成执行操作 | sqlite3_step() has finished executing */
下一篇我们将走进FMResultSet中的世界，一探究竟。