关闭

FMDB的用法讲解

187人阅读 评论(0) 收藏 举报
分类:

今天写一下 关于FMDB的笔记,FMDB是一个强大的第三方库,对sql语句进行了封装,并在并发数据库操作上做了处理,听起来那么像hibernate 似的,本文主要翻译于github上对FMDB的使用,地址:https://github.com/ccgus/fmdb,另外推荐大家一个sql语法的教学网址:http://www.runoob.com/sqlite/sqlite-constraints.html,希望可以帮助大家。

ARC 和 MRC
项目中使用 ARC 还是 MRC,对使用 FMDB 都没有任何影响,FMDB 会在编译项目时自动匹配。

导入
导入FMDB前 先在工程内导入libsqlite3.0.tbd这个库

使用

在 FMDB 中有三个重要的类:
FMDatabase:是一个提供 SQLite 数据库的类,用于执行 SQL 语句。
FMResultSet:用在 FMDatabase 中执行查询的结果的类。
FMDatabaseQueue:在多线程下查询和更新数据库用到的类。

数据库创建
FMDatabase 是通过一个 SQLite 数据库文件路径创建的,此路径可以是以下三者之一:
1,一个文件的系统路径。磁盘中可以不存在此文件,因为如果不存在会自动为你创建。
2,一个空的字符串 @”“。会在临时位置创建一个空的数据库,当 FMDatabase 连接关闭时,该数据库会被删除。
3,NULL。会在内存中创建一个数据库,当 FMDatabase 连接关闭时,该数据库会被销毁。

// 创建数据库示例
FMDatabase *db = [FMDatabase databaseWithPath:@"你所要写的地址.db"];

数据库必须是打开状态,才能与之交互。如果没有足够的资源和权限来打开\创建数据库,数据库会打开失败。

数据库更新
SQL 语句中除过 SELECT 语句都可以称之为更新操作。包括 CREATE,UPDATE,INSERT,ALTER,COMMIT,BEGIN,DETACH,DROP,END,EXPLAIN,VACUUM,REPLACE 等。一般只要不是以 SELECT 开头的 SQL 语句,都是更新语句。

执行更新语句后会返回一个 BOOL 值,返回 YES 表示执行更新语句成功,返回 NO 表示出现错误,可以通过调用 -lastErrorMessage 和 -lastErrorCode 方法获取更多错误信息。

数据库查询
通过调用 -executeQuery… 方法之一执行 SELECT 语句进行数据库查询操作。

执行查询操作后,如果成功会返回一个 FMResultSet 对象,反之会返回 nil。通过 -lastErrorMessage 和 -lastErrorCode 方法可以确定为什么会查询失败。

为了遍历查询结果,需要 while() 循环,然后逐条记录查看。在 FMDB 中,可以通过下面的简单方式实现:

FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];
while ([s next]) {
    // 每条记录的检索值,即数据库查询出来的某条数据;
}

即使只需要获取一个数据,也还是必须在访问查询结果前调用 -[FMResultSet next]。

// 示例
FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];
if ([s next]) {
    int totalCount = [s intForColumnIndex:0];
    //此处可以通过index取值,也可以通过 键 来取值
}

FMResultSet 提供了很多方便的方法来查询数据:

intForColumn:
longForColumn:
longLongIntForColumn:
boolForColumn:
doubleForColumn:
stringForColumn:
dateForColumn:
dataForColumn:
dataNoCopyForColumn:
UTF8StringForColumn:
objectForColumn:

这些方法都有一个 {type}ForColumnIndex: 变体,是基于列的位置来查询数据。

通常情况下,一个 FMResultSet 没有必要手动 -close,因为结果集合 (result set) 被释放或者源数据库关闭会自动关闭。

关闭数据库
当对数据库进行查询和更新操作完成后,需要调用 -close 关闭数据库 FMDatabase 的连接。

// 示例
[db close];

事务
FMDatabase 可以通过调用方法来开始和提交事务,也可以通过执行开始\结束事务 (begin\end transaction) 语句。

多语句和批处理
FMDatabase 可以通过 -executeStatements:withResultBlock: 方法在一个字符串中执行多语句。

// 示例
NSString *sql = @"create table bulktest1 (id integer primary key autoincrement, x text);"
                 "create table bulktest2 (id integer primary key autoincrement, y text);"
                 "create table bulktest3 (id integer primary key autoincrement, z text);"
                 "insert into bulktest1 (x) values ('XXX');"
                 "insert into bulktest2 (y) values ('YYY');"
                 "insert into bulktest3 (z) values ('ZZZ');";

success = [db executeStatements:sql];

sql = @"select count(*) as count from bulktest1;"
       "select count(*) as count from bulktest2;"
       "select count(*) as count from bulktest3;";

success = [self.db executeStatements:sql withResultBlock:^int(NSDictionary *dictionary) {
    NSInteger count = [dictionary[@"count"] integerValue];
    XCTAssertEqual(count, 1, @"expected one record for dictionary %@", dictionary);
    return 0;
}];

数据处理
当给 FMDB 提供 SQL 语句时,在插入前不应该处理任何数据,而应该使用标准的 SQLite 的绑定语法。

// 示例
INSERT INTO myTable VALUES (?, ?, ?)

? 问号在 SQLite 中意为即将插入的值的占位符,FMDB 执行语句的方法都接受多个参数 (或者参数集合,比如 NSArray,NSDictionary,va_list),它们都会正确转义。

// 示例
INSERT INTO myTable VALUES (?, ?, ?)

也可以使用命名参数语法:

// 示例 这些语法问题可以在我推荐的链接里学习
INSERT INTO myTable VALUES (:id, :name, :value)

这些参数必须以冒号开头,SQLite 自身支持其他字符,但是命名时字典的键内部以冒号开头,就不能在你的字典的键中包含冒号。

// 示例
NSDictionary *argsDict = [NSDictionary dictionaryWithObjectsAndKeys:@"My Name", @"name", nil];
[db executeUpdate:@"INSERT INTO myTable (name) VALUES (:name)" withParameterDictionary:argsDict];

因此,不应该写类似下面这行一样的错误代码:

// 错误示例
[db executeUpdate:[NSString stringWithFormat:@"INSERT INTO myTable VALUES (%@)", @"this has \" lots of ' bizarre \" quotes '"]];

而应该这样写:

// 正确示例
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", @"this has \" lots of ' bizarre \" quotes '"];

也可以使用 -execute*WithFormat: 这个方法将数字转换成字符串:

// 转换成字符串示例
[db executeUpdateWithFormat:@"INSERT INTO myTable VALUES (@d)", 42];

-execute*WithFormat: 这些方法后面都可以接格式字符串参数,以下 % 百分号格式符都是可以识别的:%@, %c, %s, %d, %D, %i, %u, %U, %hi, %hu, %qi, %qu, %f, %g, %ld, %lu, %lld, %llu。使用其他格式符可能会出现不可预知的问题。出于某种原因,可能需要在你的 SQL 语句中使用 % 字符,应该使用百分号转义一下 %%。

FMDatabaseQueue 队列和线程安全
在多线程中同时使用 FMDatabase 单例是极其错误的想法,会导致每个线程创建一个 FMDatabase 对象。不要跨线程使用单例,也不要同时跨多线程,不然会奔溃或者异常。

因此不要实例化一个 FMDatabase 单例来跨线程使用。

相反,使用 FMDatabaseQueue,下面就是它的使用方法:

第一,创建队列。

// 创建 FMdatabaseQueue 示例
FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:aPath];

然后这样使用:

// 示例
[queue inDatabase:^(FMDatabase *db) {
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:1]];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:2]];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:3]];

    FMResultSet *rs = [db executeQuery:@"select * from foo"];
    while ([rs next]) {
        ...
    }
}];

把操作放在事务中也很简单明了,比如:

// 示例
[queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:1]];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:2]];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:3]];

    if (whoopsSomethingWrongHappened) {
        *rollback = YES;
        return;
    }
    // ...
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:4]];
}];

FMDatabase 将块代码 block 运行在一个串行队列上,即使在多线程同时调用 FMDatabaseQueue 的方法,它们仍然还是顺序执行。这种查询和更新方式不会影响其它,是线程安全的。

关于oc的FMDB的翻译就这么多 或许大家看了这么多还不知道如何系统使用一次,我贴一段代码给大家:

//创建数据库
+(void)creatTablefh
{
    FMDatabase * db=[EGDatabaseUtil getDB];//创建表所在的文件地址
    if (![db open])
    {
        [db close];
        NSLog(@"打开数据库失败");
        return;
    }
    [db setShouldCacheStatements:YES];
    if (![db tableExists:@"FetalHeartRateTable"])
    {
        [db executeUpdate:@"create table if not exists FetalHeartRateTable(uid integer, record_time integer ,average integer, duration integer,value Varchar, screenshot Varchar,media Varchar,fid integer, isAdult integer,isUploadSuccess integer,snapShotData Varchar ,primary key(record_time,uid))"];
    }
    [db close];
}//表字段的格式 大家可以通过我推荐的链接 查看。
表的地址
+(NSString *)getDBFilePath
{
    return [NSHomeDirectory() stringByAppendingPathComponent:@"Documents/db.sqlite"];
}
//创建数据库
+ (FMDatabase * )getDB
{
    //NSLog(@"%@",[NSHomeDirectory() stringByAppendingPathComponent:@"Documents/db.sqlite"]);

    if (!_db) {
        _db = [[FMDatabase alloc]initWithPath:[self getDBFilePath]];
    }
    return _db;
}
我们以查询语句为例 :
+(NSMutableArray *)getAllFetalHeartDataById :(int)userId
{
    FMDatabase * db=[EGDatabaseUtil getDB];
    if (![db open])
    {
        [db close];
        return nil;
    }
    FMResultSet *set=[db executeQuery:@"select * from FetalHeartRateTable  where uid = ? ORDER BY record_time",[NSNumber numberWithInt:userId]];
    NSMutableArray * array=[[NSMutableArray alloc]initWithCapacity:0];
    while ([set next])//查找表的下一列的所有数据
    {
        EGFeltaHeartRateModel * fh=[[EGFeltaHeartRateModel alloc]init];
        fh.uid = [set intForColumn:@"uid"];
        fh.record_time = [set doubleForColumn:@"record_time"];
        fh.average = [set doubleForColumn:@"average"];
        fh.duration = [set intForColumn:@"duration"];
        fh.values = [set stringForColumn:@"value"];
        fh.screenshot = [set stringForColumn:@"screenshot"];
        fh.media = [set stringForColumn:@"media"];
        fh.fid = [set intForColumn:@"fid"];
        fh.isAdult = [set intForColumn:@"isAdult"];
        [array addObject:fh];

    }
    [set close];
    [db close];

    return array;
}

这样我们就可以完成整个 数据库的操作流程。 谢谢

1
0
查看评论
发表评论
* 以上用户言论只代表其个人观点,不代表CSDN网站的观点或立场

FMDB源码分析

一、前言 如上一章所讲,FMDB源码主要有以下几个文件组成: FMResultSet : 表示FMDatabase执行查询之后的结果集。 FMDatabase : 表示一个单独的SQ...
  • leikezhu1981
  • leikezhu1981
  • 2016-06-14 23:19
  • 551

IOS开发源码阅读篇--FMDB源码分析1(FMResultSet)

一、前言FMDB是IOS平台的SQLite数据库框架,以OC的方式封装了SQLite的C语言的API。FMDB使用起来更加的面向对象,省去了很多麻烦、冗余的C语言代码(具体对比详见我的博客IOS开发数...
  • yixiangboy
  • yixiangboy
  • 2016-04-28 14:43
  • 2425

FMDB 在多线程中的使用

在App中保持一个FMDatabaseQueue的实例,并在所有的线程中都只使用这一个实例。[FMDatabaseQueue databaseQueueWithPath:path]FMDatabase...
  • zhangao0086
  • zhangao0086
  • 2015-03-12 16:05
  • 21008

FMDB的基本使用

写在前面在编程的世界里,总少不了和数据库打交道,毕竟这大千世界的数据太多,总有一个好的方法去管理,数据库技术就诞生了。这里主要介绍iOS中FMDB第三方库如何操作数据库的。FMDB github链接...
  • u012437355
  • u012437355
  • 2016-09-02 12:59
  • 281

数据库操作(使用FMDB)

iOS中原生的SQLite API在使用上相当不友好,在使用时,非常不便。于是,就出现了一系列将SQLite API进行封装的库,例如FMDB、PlausibleDatabase、sqlitepers...
  • mr_liu_easy_ios
  • mr_liu_easy_ios
  • 2016-05-24 09:38
  • 3184

关于FMDB的讲解

关于FMDB的讲解以下参考文章讲得挺不错,所以直接引用。 http://www.cocoachina.com/bbs/read.php?tid=140901 http://www.cn...
  • zhangzhaoyuan1016
  • zhangzhaoyuan1016
  • 2016-01-22 09:46
  • 92

FMDB的使用详解以及一个简单的小例子

整个Demo是根据文顶顶的博客里的内容做出来的,在这里我想详细的写一下我的整个的使用过程。 文顶顶博客地址:iOS开发数据库篇FMDB简单介绍 ---------------------------...
  • huanghuanghonghong
  • huanghuanghonghong
  • 2016-04-20 19:48
  • 3570

iOS中FMDB简介

1、什么是FMDB  1.   iOS中原生的SQLite API在使用上相当不好用,在使用时,非常不便。于是,就出现了一系列将SQLite API进行封装的代码库,例如FMDB、    Plaus...
  • swanzhu
  • swanzhu
  • 2015-09-16 19:41
  • 972

iOS-FMDB+runtime封装,简单实用,省去复杂的sql语句.

在iOS开发中,为了得到以上SQL语句,如果是手动地添加模型属性,代码就冗余了,也就是增加代码量,可读性差,而且如果改变了模型的某个属性的名称,SQL语句相应的位置要发生改变。增,删,改,查,都要改变...
  • samuelandkevin
  • samuelandkevin
  • 2016-11-07 13:30
  • 2489

FMDB性能优化问题。使用FMDB事务批量更新数据库速度问题。(亲测可以呀---740条数据用和不用事务效率差别20倍+)

今天比较闲看到大家在群里讨论关于数据库操作的问题,其中谈到了“事务”这个词,坦白讲虽然作为计算机专业的学生,在上学的时候确实知道存储过程、触发器、事务等等这些名词的概念,但是由于毕业后从事的不是服务器...
  • cos_sin_tan
  • cos_sin_tan
  • 2016-03-29 10:53
  • 1286
    个人资料
    • 访问:2878次
    • 积分:177
    • 等级:
    • 排名:千里之外
    • 原创:13篇
    • 转载:1篇
    • 译文:1篇
    • 评论:1条
    文章分类
    最新评论
  • 蓝牙广播包

    YoungerSaner: 采购了一批i beacon设备 ,现在想用UUID来区分哪些是自己的设备,然后用MAC地址来确定具体...