FMDB - - 归纳整理- Vic_Li

原创 2015年11月20日 20:34:52

一、简单说明

1.什么是FMDB

FMDB是iOS平台的SQLite数据库框架

FMDB以OC的方式封装了SQLite的C语言API

 

2.FMDB的优点

使用起来更加面向对象,省去了很多麻烦、冗余的C语言代码

对比苹果自带的Core Data框架,更加轻量级和灵活

提供了多线程安全的数据库操作方法,有效地防止数据混乱

 

3.FMDB的github地址

https://github.com/ccgus/fmdb

 

二、核心类

FMDB有三个主要的类

(1)FMDatabase

一个FMDatabase对象就代表一个单独的SQLite数据库用来执行SQL语句

 

(2)FMResultSet

使用FMDatabase执行查询后的结果集

 

(3)FMDatabaseQueue

用于在多线程中执行多个查询或更新,它是线程安全的

 

三、打开数据库

通过指定SQLite数据库文件路径来创建FMDatabase对象

       获得数据库文件的路径--拼接路径
     NSString *doc=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
     NSString *fileName=[doc stringByAppendingPathComponent:@"student.sqlite"];

//根据路径创建数据库

打开数据库

FMDatabase *db = [FMDatabase databaseWithPath:path];

在和数据库交互 之前,数据库必须是打开的。如果资源或权限不足无法打开或创建数据库,都会导致打开失败。

if (![db open]) {//判断打开是否成功

    NSLog(@"数据库打开失败!");

}


文件路径有三种情况

(1)具体文件路径

  如果不存在会自动创建

(2)空字符串@""

  会在临时目录创建一个空的数据库

  当FMDatabase连接关闭时,数据库文件也被删除

(3)nil

  会创建一个内存中临时数据库,当FMDatabase连接关闭时,数据库会被销毁

 

四、执行更新

一切不是SELECT命令的命令都视为更新。这包括  CREATE, UPDATE, INSERT,ALTER,COMMIT, BEGIN, DETACH, DELETE, DROP, END, EXPLAIN, VACUUM, and REPLACE  (等)。
简单来说,只要不是以SELECT开头的命令都是UPDATE命令。

使用executeUpdate:方法执行更新

- (BOOL)executeUpdate:(NSString*)sql, ...

- (BOOL)executeUpdateWithFormat:(NSString*)format, ...

- (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments

示例

[db executeUpdate:@"UPDATE t_student SET age = ? WHERE name = ?;", @20, @"Jack”]

 执行更新返回一个BOOL值。YES表示执行成功,否则表示有那些错误 。你可以调用 -lastErrorMessage 和 -lastErrorCode方法来得到更多信息。


提供给 -executeUpdate: 方法的参数都必须是对象。就像以下的代码就无法工作,且会产生崩溃。
  1. [db executeUpdate:@"INSERT INTO myTable VALUES (?)", 42];   
 正确有做法是把数字打包成 NSNumber对象
  1. [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:42]];   
或者,你可以使用  -execute*WithFormat: ,这是NSString风格的参数
  1. [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, and %llu.  除此之外的修饰符可能导致无法预知的结果。 一些情况下,你需要在SQL语句中使用 % 字符,你应该使用 %%。
 



五、执行查询

查询方法

- (FMResultSet *)executeQuery:(NSString*)sql, ...

- (FMResultSet *)executeQueryWithFormat:(NSString*)format, ...

- (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments

示例

// 查询数据 -  查询结果是以 FMResultSet 结果集 的形式

FMResultSet *rs = [db executeQuery:@"SELECT * FROM t_student"];

 

执行查询时,如果成功返回FMResultSet对象, 错误返回nil. 与执行更新相当,支持使用 NSError**参数。同时,你也可以使用 -lastErrorCode-lastErrorMessage获知错误信息。


为了遍历查询结果,你可以使用while循环。你还需要知道怎么跳到下一个记录。使用FMDB,很简单实现,就像这样:

// 遍历结果集

  1. FMResultSet *rs = [db executeQuery:@"SELECT * FROM myTable"];   
  2. while ([rs  next]) {   
  3.     //retrieve values for each record
  4.   NSString *name = [rs stringForColumn:@"name"];

        int age = [rs intForColumn:@"age"];

        double score = [rs doubleForColumn:@"score"];   
  5. }   
 
你必须一直调用   -[FMResultSet next]   在你访问查询返回值之前,甚至你只想要一个记录:
 
  1. FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];   
  2.   if ([s next]) {    
  3.        int totalCount = [s intForColumnIndex:0];   
  4.   }   


FMResultSet  提供了很多方法来获得所需的格式的值:
    intForColumn:
    longForColumn:
    longLongIntForColumn:
    boolForColumn:
    doubleForColumn:
    stringForColumn:
    dataForColumn:
    dataNoCopyForColumn:
    UTF8StringForColumnIndex:
    objectForColumn:

这些方法也都包括 {type}ForColumnIndex 的这样子的方法,参数是查询结果集的列的索引位置。
 
你无需调用  [FMResultSet close]来关闭结果集当新的结果集产生,或者其数据库关闭时,会自动关闭
 
关闭数据库
当使用完数据库,你应该 -close 来关闭数据库连接来释放SQLite使用的资源。
    [db close];  

 


六事务
 
FMDatabase是支持事务的。
 
数据净化(数据格式化
 
使用FMDB,插入数据前,你不要花时间审查你的数据。你可以使用标准的SQLite数据绑定语法。
 
  1. INSERT INTO myTable VALUES (?, ?, ?)   
eg: NSString *name = [NSString stringWithFormat:@"jack-%d", arc4random_uniform(100)];
55         // executeUpdate : 不确定的参数用?来占位
56         [self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);", name, @(arc4random_uniform(40))];
57         //        [self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);" withArgumentsInArray:@[name, @(arc4random_uniform(40))]];
58         <Arguments:参数>

59         // executeUpdateWithFormat : 不确定的参数用%@、%d等来占位
60         //        [self.db executeUpdateWithFormat:@"INSERT INTO t_student (name, age) VALUES (%@, %d);", name, arc4random_uniform(40)];

SQLite会识别 “?” 为一个输入的点位符, 这样的执行会接受一个可变参数(或者表示为其他参数,如NSArray, NSDictionary,或va_list等),会正确为您转义。
 

你也可以选择使用命名参数语法。
 
  1. INSERT INTO myTable VALUES (:id, :name, :value)   
参数名必须以冒名开头。SQLite本身支持其他字符,当Dictionary key的内部实现是冒号开头。注意你的NSDictionary key不要包含冒号。
 
  1. NSDictionary *argsDict = [NSDictionary dictionaryWithObjectsAndKeys:@"My Name", @"name", nil];    
  2. //
  3.     [db executeUpdate:@"INSERT INTO myTable (name) VALUES (:name)" withParameterDictionary:argsDict];   <Parameter:参数>
 
而且,代码不能这么写(为什么?想想吧。)
  1. [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @"this has \" lots of ' bizarre \" quotes '"]; 
你应该:
 

  1. [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @"this has " lots of ' bizarre " quotes '"];   




七.使用FMDatabaseQueue 及线程安全
在多个线程中同时使用一个FMDatabase实例是不明智的。现在你可以为每个线程创建一个FMDatabase对象。 不要让多个线程分享同一个实例,它无法在多个线程中同时使用。 若此,坏事会经常发生,程序会时不时崩溃,或者报告异常,。所以,不要初始化FMDatabase对象,然后在多个线程中使用。请使用 FMDatabaseQueue,它是你的朋友而且会帮助你。以下是使用方法:
 
首先创建队列。
 
  1. FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:aPath]; 
这样使用。
  1. [queue inDatabase:^(FMDatabase *db) {    
  2.           [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:1]];    
  3.           [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:2]];    
  4.           [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:3]];    
  5.           FMResultSet *rs = [db executeQuery:@"select * from foo"];    
  6.          while([rs next]) {   
  7.             …    
  8.          }    
  9. }];   
像这样,轻松地把简单任务包装到事务里:
  1. [queue inTransaction:^(FMDatabase *db, BOOL *rollback) {    
  2.             [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:1]];    
  3.             [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:2]];    
  4.             [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:3]];    
  5.             if (whoopsSomethingWrongHappened) {    
  6.                     *rollback = YES; return;    
  7.             }   
  8.             // etc…    
  9.             [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:4]];    
  10.     }];   
 
 FMDatabaseQueue  后台会建立系列化的G-C-D队列,并执行你传给G-C-D队列的块。这意味着 你从多线程同时调用调用方法,GDC也会按它接收的块的顺序来执行。




八、代码示例

1.新建一个项目,导入libsqlite3库,并在项目中包含主头文件

2.下载第三方框架FMDB

  

3.示例代码


复制代码

 8 
 9 #import "YYViewController.h"
10 #import "FMDB.h"
11 
12 @interface YYViewController ()
13 @property(nonatomic,strong)FMDatabase *db;
14 @end
15 
16 @implementation YYViewController
17 
18 - (void)viewDidLoad
19 {
20     [super viewDidLoad];

21     //1.获得数据库文件的路径--拼接路径
22     NSString *doc=[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
23     NSString *fileName=[doc stringByAppendingPathComponent:@"student.sqlite"];
24     
25     //2.获得数据库
26     FMDatabase *db=[FMDatabase databaseWithPath:fileName];
27     
28     //3.打开数据库
29     if ([db open]) {//判断是否正常打开 <如果资源或权限不足无法打开或创建数据库,都会导致打开失败。>
30         //4.创表—SQ语句
31         BOOL result=[db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
32         if (result) {
33             NSLog(@"创表成功");
34         }else
35         {
36             NSLog(@"创表失败");
37         }
38     }
39     self.db=db;
40 
41 }
42 
43 -(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event
44 {
45     [self delete];
46     [self insert];
47     [self query];
48 }

49 简单来说,只要不是以SELECT开头的命令都是UPDATE命令
 使用executeUpdate:方法执行更新

- (BOOL)executeUpdate:(NSString*)sql, ...

- (BOOL)executeUpdateWithFormat:(NSString*)format, ...

- (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)argument

50 //插入数据 51 -(void)insert 52 { 53 for (int i = 0; i<10; i++) { 54 NSString *name = [NSString stringWithFormat:@"jack-%d", arc4random_uniform(100)]; 55 // executeUpdate : 不确定的参数用?来占位 <SQLite会识别 “?” 为一个输入的点位符, 这样的执行会接受一个可变参数(或者表示为其他 参数,如NSArray, NSDictionary,或va_list等),会正确为您转义。>
56         [self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);", name, @(arc4random_uniform(40))];
57         //        [self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);" withArgumentsInArray:@[name, @(arc4random_uniform(40))]];
58         
59         // executeUpdateWithFormat : 不确定的参数用%@、%d等来占位
60         //        [self.db executeUpdateWithFormat:@"INSERT INTO t_student (name, age) VALUES (%@, %d);", name, arc4random_uniform(40)];
               -execute*WithFormat:  的方法的内部实现会帮你封装数据, 以下这些修饰符都可以使用: %@, %c, %s, %d, %D,%i, %u, %U, %hi, %hu, %qi, %qu, %f, %g, %ld, %lu, %lld, and %llu.  除此之外的修饰符可能导致无法预知的结果。 一些情况下,你需要在SQL语句中使用 % 字符,你应该使用 %%。
61     }
62 }
63 

64 //删除数据
65 -(void)delete
66 {
67     //    [self.db executeUpdate:@"DELETE FROM t_student;”];//删除全部
68     [self.db executeUpdate:@"DROP TABLE IF EXISTS t_student;]; //删除对应表
69     [self.db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);];//建表
70 }
71执行更新返回一个BOOL值。YES表示执行成功,否则表示有那些错误 。你可以调用 -lastErrorMessage 和 -lastErrorCode方法来得到更多信息。 

执行查询
SELECT命令就是查询,执行查询的方法是以 -excuteQuery开头的。

查询方法

- (FMResultSet *)executeQuery:(NSString*)sql, ...

- (FMResultSet *)executeQueryWithFormat:(NSString*)format, ...

- (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments

示例

// 查询数据 -  查询结果是以 FMResultSet 结果集 的形式

FMResultSet *rs = [db executeQuery:@"SELECT * FROM t_student"];


72 //查询
73 - (void)query
74 {
75     // 1.执行查询语句
76     FMResultSet *resultSet = [self.db executeQuery:@"SELECT * FROM t_student"];
77     
78     // 2.遍历结果
79     while ([resultSet next]) {
80         int ID = [resultSet intForColumn:@"id"];
81         NSString *name = [resultSet stringForColumn:@"name"];
82         int age = [resultSet intForColumn:@"age"];
83         NSLog(@"%d %@ %d", ID, name, age);
84     }
85 }
87 @end

执行查询时,如果成功返回FMResultSet对象, 错误返回nil. 与执行更新相当,支持使用 NSError**参数。同时,你也可以使用 -lastErrorCode-lastErrorMessage获知错误信息。

FMResultSet  提供了很多方法来获得所需的格式的值:
    intForColumn:
    longForColumn:
    longLongIntForColumn:
    boolForColumn:
    doubleForColumn:
    stringForColumn:
    dataForColumn:
    dataNoCopyForColumn:
    UTF8StringForColumnIndex:
    objectForColumn:
 
这些方法也都包括 {type}ForColumnIndex 的这样子的方法,参数是查询结果集的列的索引位置。
 
你无需调用  [FMResultSet close]来关闭结果集, 当新的结果集产生,或者其数据库关闭时,会自动关闭。
 
关闭数据库
当使用完数据库,你应该 -close 来关闭数据库连接来释放SQLite使用的资源。
    [db close];  
复制代码

打印查看结果:

提示:

如果ID设置为逐渐,且设置为自动增长的话,那么把表中的数据删除后,重新插入新的数据,ID的编号不是从0开始,而是接着之前的ID进行编号。

注意:

  不要写成下面的形式不要加'',直接使用%@,它会自动认为这是一个字符串。  jack - %d   -   %@         

 

版权声明:VIC

来自西弗吉利亚大学li xin整理的CV代码合集(转)

目录(?)[-] Image denoisingImage codingImage demosaicingImage interpolation and SuperresolutionRGBD ...
  • shuzfan
  • shuzfan
  • 2015年03月24日 15:25
  • 2662

来自西弗吉利亚大学li xin整理的CV代码合集

原创 2014年03月11日 11:09:22 标签:人工智能 /机器学习 /图像处理 /计算机视觉 11680 Reproducible Research in Computa...
  • ruiZjun
  • ruiZjun
  • 2017年11月24日 14:24
  • 95

来自西弗吉利亚大学li xin整理的CV代码合集

Reproducible Research in Computational Science   “It doesn't matter how beautiful your theory is...

来自西弗吉利亚大学li xin整理的CV代码合集

Reproducible Research in Computational Science   “It doesn't matter how beautiful your theory is, i...

来自西弗吉利亚大学li xin整理的CV代码合集

Reproducible Research in Computational Science   “It doesn't matter how beautiful your theory is...

iOS个人整理42-FMDB

创建FMDatabas对象时参数为SQLite数据库文件路径,该路径可以是一下三种方法之一1.文件路径。该文件路径无需真实存在,如果不存在会自动创建2.空字符串@”“,表示会在临时目录创建一个空的数据...

FMDB慢慢整理

来自: http://my.oschina.net/TaciturnKnightYQ/blog/617795一、FMDB架构图二、核心类FMDatabase一个FMDatabase对象就代表一个单独的...

FMDB 常用操作整理

具体的文档可以参照官方说明FMDB github,这里只是日常一些操作的说明需要注意的是,直接使用 FMDatabase 实例时要考虑线程安全的问题,FMDatabaseQueue 可以直接跨线程使用...

来自西弗吉利亚大学li xin整理的CV代码合集

来自西弗吉利亚大学li xin整理的CV代码合集 分类: 机器学习&&计算机视觉&&数据挖掘&&推荐系统 2014-03-11 11:09 130人阅读 评论(0) 收藏 举报 ...
  • titer1
  • titer1
  • 2014年06月13日 09:54
  • 15603

来自西弗吉利亚大学li xin整理的CV代码合集

人工智能机器学习图像处理计算机视觉 目录(?)[-] Image denoisingImage codingImage demosaicingImage interpolation...
内容举报
返回顶部
收藏助手
不良信息举报
您举报文章:FMDB - - 归纳整理- Vic_Li
举报原因:
原因补充:

(最多只允许输入30个字)