如上一章所讲,FMDB源码主要有以下几个文件组成:
1.FMResultSet : 表示FMDatabase执行查询之后的结果集。
2.FMDatabase : 表示一个单独的SQLite数据库操作实例,通过它可以对数据库进行增删改查等等操作。
3.FMDatabaseAdditions : 扩展FMDatabase类,新增对查询结果只返回单个值的方法进行简化,对表、列是否存在,版本号,校验SQL等等功能。
4.FMDatabaseQueue : 使用串行队列 ,对多线程的操作进行了支持。
5.FMDatabasePool : 使用任务池的形式,对多线程的操作提供支持。(不过官方对这种方式并不推荐使用,优先选择FMDatabaseQueue的方式:ONLY_USE_THE_POOL_IF_YOU_ARE_DOING_READS_OTHERWISE_YOULL_DEADLOCK_USE_FMDATABASEQUEUE_INSTEAD)
这一篇我们就来讲讲FMDatabase和FMDatabaseAdditions的实现思路。
FMDatabase源码分析
1.1:打开数据库连接
-(BOOL)open;其实是对sqlite3_open()函数的封装。
- (BOOL)open {
if (_db) {
return YES;
}
int err = sqlite3_open([self sqlitePath], (sqlite3**)&_db );
if(err != SQLITE_OK) {
NSLog(@"error opening!: %d", err);
return NO;
}
//当执行这段代码的时候,数据库正在被其他线程访问,那我们就需要给他设置一个重试时间,默认为2秒。
if (_maxBusyRetryTimeInterval > 0.0) {
// set the handler
[self setMaxBusyRetryTimeInterval:_maxBusyRetryTimeInterval];
}
return YES;
}
- (void)setMaxBusyRetryTimeInterval:(NSTimeInterval)timeout {
_maxBusyRetryTimeInterval = timeout;
if (!_db) {
return;
}
if (timeout > 0) {
sqlite3_busy_handler(_db, &FMDBDatabaseBusyHandler, (__bridge void *)(self));
}
else {
// turn it off otherwise
sqlite3_busy_handler(_db, nil, nil);
}
}
setMaxBusyRetryTimeInterval设置重试时间,其实调用的是
int sqlite3_busy_handler(sqlite3*,int()(void,int),void*);
该函数的第一个参数为:需要告知哪一个数据库需要设置busy handler。
第二个参数是需要回调的busy handler,当你调用该回调函数的时候,需要传递给它一个void*的参数拷贝,也就是sqlite3_busy_handler的第三个参数。
另一个需要传给回调函数的int参数表示这次锁事件,该回调函数被调用的次数。
如果回调函数返回0时,将不再尝试再次访问数据库而返回SQLITE_BUSY或者SQLITE_IOERR_BLOCKED.如果回调函数返回非0,将会不断尝试操作数据困。
程序运行过程中,如果有其他进程或者线程在读写数据库,那么sqlite3_busy_handler会不断调用该回调函数,直到其他线程或者进程释放锁。获得锁之后,不会再调用该回调函数,从而继续向下执行下去,进行数据库操作。该函数是在获取不到锁的时候,以执行回调函数的次数来进行延时,等待其他进程或者线程操作数据库结束,从而获得锁进行操作数据库。
2.2:查询数据库
executeQuery系列函数从根本上看其实调用的都是
-(FMResultSet )executeQuery:(NSString )sql withArgumentsInArray:(NSArray*)arrayArgs orDictionary:(NSDictionary *)dictionaryArgs orVAList:(va_list)args
参数sql : 需要查询的sql语句。
参数arrayArgs : 数组类型的参数。应于于
FMResultSet *resultSet = [_db executeQuery:@"SELECT * FROM t_student WHERE age > ?" withArgumentsInArray:@[@25]];
参数dictionaryArgs:字典类型的参数。应用于
FMResultSet *resultSet = [_db executeQuery:@"SELECT * FROM t_student WHERE age > :age" withParameterDictionary:@{@"age":@25}];
参数args:可变参数类型。应用于
FMRes