FMDatabase的一些基本操作小结

最新推荐文章于 2016-06-24 16:43:59 发布

空中海

最新推荐文章于 2016-06-24 16:43:59 发布

阅读量1.7k

点赞数

分类专栏：数据库

数据库专栏收录该内容

20 篇文章 0 订阅

订阅专栏

由于FMDB是建立在SQLite的之上的，所以你至少也该把这篇文章从头到尾读一遍。
与此同时，把SQLite的文档页 http://www.sqlite.org/docs.html 加到你的书签中。
自动引用计数（APC）还是手动内存管理呢？

两种都行，FMDB会在编译的时候知道你是用的哪一种，然后进行相应处理。
使用方法

FMDB有三个主要的类

    FMDatabase – 表示一个单独的SQLite数据库。 用来执行SQLite的命令。
    FMResultSet – 表示FMDatabase执行查询后结果集
    FMDatabaseQueue – 如果你想在多线程中执行多个查询或更新，你应该使用该类。这是线程安全的。

数据库创建

创建FMDatabase对象时参数为SQLite数据库文件路径。该路径可以是以下三种之一：
文件路径。该文件路径无需真实存，如果不存在会自动创建。
空字符串(@”")。表示会在临时目录创建一个空的数据库，当FMDatabase 链接关闭时，文件也被删除。
NULL. 将创建一个内在数据库。同样的，当FMDatabase连接关闭时，数据会被销毁。
(如需对临时数据库或内在数据库进行一步了解，请继续阅读：http://www.sqlite.org/inmemorydb.html)


    FMDatabase *db = [FMDatabase databaseWithPath:@"/tmp/tmp.db"];  

打开数据库

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


    if (![db open]) {   
        [db release];  
        return;   
    }   

执行更新

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

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

SELECT命令就是查询，执行查询的方法是以 -excuteQuery开头的。
执行查询时，如果成功返回FMResultSet对象， 错误返回nil. 与执行更新相当，
支持使用 NSError**参数。同时，你也可以使用 -lastErrorCode和-lastErrorMessage获知错误信息。
为了遍历查询结果，你可以使用while循环。你还需要知道怎么跳到下一个记录。使用FMDB，很简单实现，就像这样：


    FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];  
    while ([s next]) {  
        //retrieve values for each record  
    }  

你必须一直调用   -[FMResultSet next]   在你访问查询返回值之前，甚至你只想要一个记录：



    FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];  
    if ([s next]) {   
         int totalCount = [s intForColumnIndex:0];  
    }  

FMResultSet  提供了很多方法来获得所需的格式的值：

    intForColumn:
    longForColumn:
    longLongIntForColumn:
    boolForColumn:
    doubleForColumn:
    stringForColumn:
    dataForColumn:
    dataNoCopyForColumn:
    UTF8StringForColumnIndex:
    objectForColumn:

这些方法也都包括 {type}ForColumnIndex 的这样子的方法，参数是查询结果集的列的索引位置。

你无需调用  [FMResultSet close]来关闭结果集, 当新的结果集产生，或者其数据库关闭时，会自动关闭。
关闭数据库

当使用完数据库，你应该 -close 来关闭数据库连接来释放SQLite使用的资源。

    [db close];  

事务

FMDatabase是支持事务的。
数据净化（数据格式化）

使用FMDB，插入数据前，你不要花时间审查你的数据。你可以使用标准的SQLite数据绑定语法。

    INSERT INTO myTable VALUES (?, ?, ?)  

SQLite会识别 “?” 为一个输入的点位符， 这样的执行会接受一个可变参数（或者表示为其他参数，如NSArray, NSDictionary,或va_list等），会正确为您转义。
你也可以选择使用命名参数语法。

    INSERT INTO myTable VALUES (:id, :name, :value)  

参数名必须以冒名开头。SQLite本身支持其他字符，当Dictionary key的内部实现是冒号开头。注意你的NSDictionary key不要包含冒号。


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

而且，代码不能这么写（为什么？想想吧。）


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

你应该：


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

提供给 -executeUpdate: 方法的参数都必须是对象。就像以下的代码就无法工作，且会产生崩溃。


    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", 42];  

正确有做法是把数字打包成 NSNumber对象


    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:42]];  

或者，你可以使用  -execute*WithFormat: ，这是NSString风格的参数


    [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语句中使用 % 字符，你应该使用 %%。
使用FMDatabaseQueue 及线程安全

在多个线程中同时使用一个FMDatabase实例是不明智的。现在你可以为每个线程创建一个FMDatabase对象。 
不要让多个线程分享同一个实例，它无法在多个线程中同时使用。 若此，坏事会经常发生，程序会时不时崩溃，
或者报告异常，或者陨石会从天空中掉下来砸到你Mac Pro.  总之很崩溃。
所以，不要初始化FMDatabase对象，然后在多个线程中使用。
请使用 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;   
            }  
            // etc…   
            [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:4]];   
    }];  

FMDatabaseQueue  后台会建立系列化的G-C-D队列，并执行你传给G-C-D队列的块。这意味着 你从多线程同时调用调用方法，
GDC也会按它接收的块的顺序来执行。谁也不会吵到谁的脚 ，每个人都幸福。


晕，G-C-D竟然会被屏蔽。


一、简单说明
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对象
FMDatabase *db = [FMDatabase databaseWithPath:path];
if (![db open]) {
    NSLog(@"数据库打开失败！");
}
 
文件路径有三种情况
（1）具体文件路径
　　如果不存在会自动创建
 
（2）空字符串@""
　　会在临时目录创建一个空的数据库
　　当FMDatabase连接关闭时，数据库文件也被删除
 
（3）nil
　　会创建一个内存中临时数据库，当FMDatabase连接关闭时，数据库会被销毁
 
四、执行更新
在FMDB中，除查询以外的所有操作，都称为“更新”
create、drop、insert、update、delete等
 
使用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"]
 
五、执行查询
查询方法
- (FMResultSet *)executeQuery:(NSString*)sql, ...
- (FMResultSet *)executeQueryWithFormat:(NSString*)format, ...
- (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments
 
示例
// 查询数据
FMResultSet *rs = [db executeQuery:@"SELECT * FROM t_student"];
 
// 遍历结果集
while ([rs next]) {
    NSString *name = [rs stringForColumn:@"name"];
    int age = [rs intForColumn:@"age"];
    double score = [rs doubleForColumn:@"score"];
}
 
六、代码示例
1.新建一个项目，导入libsqlite3库，并在项目中包含主头文件
2.下载第三方框架FMDB
　　
3.示例代码
　　YYViewController.m文件
 
 
  
  
   
   
    
    
   
   
 1 //
 2 //  YYViewController.m
 3 //  04-FMDB基本使用
 4 //
 5 //  Created by apple on 14-7-27.
 6 //  Copyright (c) 2014年 wendingding. All rights reserved.
 7 //
 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.创表
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 
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 : 不确定的参数用?来占位
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)];
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 
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 }
86 
87 @end
   
   
    
    
   
   
 
 
打印查看结果：
提示：
如果ID设置为逐渐，且设置为自动增长的话，那么把表中的数据删除后，重新插入新的数据，ID的编号不是从0开始，而是接着之前的ID进行编号。
注意：
　　不要写成下面的形式，不要加''，直接使用%@,它会自动认为这是一个字符串。



前言
SQLite (http://www.sqlite.org/docs.html) 是一个轻量级的关系数据库。iOS SDK 很早就支持了 SQLite，在使用时，只需要加入 libsqlite3.dylib 依赖以及引入 sqlite3.h 头文件即可。但是，原生的 SQLite API 在使用上相当不友好，在使用时，非常不便。于是，开源社区中就出现了一系列将 SQLite API 进行封装的库，而 FMDB (https://github.com/ccgus/fmdb) 则是开源社区中的优秀者。
FMDB 在使用上相当方便。以下是一个简单的例子：

 
 
  
  1
2
3
4
5
6
7
8
9
10
11
NSString* docsdir = [NSSearchPathForDirectoriesInDomains( NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSString* dbpath = [docsdir stringByAppendingPathComponent:@"user.sqlite"];
FMDatabase* db = [FMDatabase databaseWithPath:dbpath];
[db open];
FMResultSet *rs = [db executeQuery:@"select * from people"];
while ([rs next]) {
    NSLog(@"%@ %@",
        [rs stringForColumn:@"firstname"],
        [rs stringForColumn:@"lastname"]);
}
[db close];

 
 
可以看到，使用 FMDB 后的数据库代码清晰明了，比原生的 API 优雅多了。另外，FMDB 同时兼容 ARC 和非 ARC 工程，会自动根据工程配置来调整相关的内存管理代码。
使用说明
该使用说明主要翻译自 fmdb 的 github 项目说明文档: https://github.com/ccgus/fmdb
引入相关文件
首先将 FMDB 从 github 上 clone 下来，然后将以下文件 copy 到你的工程中：

 
 
  
  1
2
3
4
5
6
7
8
9
10
FMDatabase.h
FMDatabase.m
FMDatabaseAdditions.h
FMDatabaseAdditions.m
FMDatabasePool.h
FMDatabasePool.m
FMDatabaseQueue.h
FMDatabaseQueue.m
FMResultSet.h
FMResultSet.m

 
 
建立数据库
建立数据库只需要如下一行即可 , 当该文件不存在时，fmdb 会自己创建一个。如果你传入的参数是空串：@“” ，则 fmdb 会在临时文件目录下创建这个数据库，如果你传入的参数是 NULL，则它会建立一个在内存中的数据库。

 
 
  
  1
FMDatabase *db = [FMDatabase databaseWithPath:@"/tmp/tmp.db"];

 
 
打开数据库
使用如下语句，如果打开失败，可能是权限不足或者资源不足。通常打开完操作操作后，需要调用 close 方法来关闭数据库。

 
 
  
  1
2
3
4
5
6
7
8
if (![db open]) {
    // error 
    return;
}
// some operation
// ...

[db close];

 
 
执行更新操作
除了 Select 操作之外，其它的都是更新操作。更新操作使用如下方法，如果有错误，可以用 error 参数中获得。

 
 
  
  1
-[FMDatabase executeUpdate:error:withArgumentsInArray:orVAList:]

 
 
执行查询操作
查询操作示例如下。注意：即使操作结果只有一行，也需要先调用 FMResultSet 的 next 方法。

 
 
  
  1
2
3
4
5
6
7
8
9
FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];
while ([s next]) {
    //retrieve values for each record
}

FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];
if ([s next]) {
    int totalCount = [s intForColumnIndex:0];
}

 
 
FMDB 提供如下多个方法来获取不同类型的数据：

 
 
  
  1
2
3
4
5
6
7
8
9
10
11
intForColumn:
longForColumn:
longLongIntForColumn:
boolForColumn:
doubleForColumn:
stringForColumn:
dateForColumn:
dataForColumn:
dataNoCopyForColumn:
UTF8StringForColumnIndex:
objectForColumn:

 
 
通常情况下，你并不需要关闭 FMResultSet，因为相关的数据库关闭时，FMResultSet 也会被自动关闭。
数据参数
通常情况下，你可以按照标准的 SQL 语句，用 ? 表示执行语句的参数，如：

 
 
  
  1
INSERT INTO myTable VALUES (?, ?, ?)

 
 
然后，可以我们可以调用 executeUpdate 方法来将 ? 所指代的具体参数传入，通常是用变长参数来传递进去的，如下：

 
 
  
  1
2
NSString *sql = @"insert into User (name, password) values (?, ?)";
[db executeUpdate:sql, user.name, user.password];

 
 
这里需要注意的是，参数必须是 NSObject 的子类，所以象 int,double,bool 这种基本类型，需要封装成对应的包装类才行，如下所示：

 
 
  
  1
2
3
4
// 错误，42 不能作为参数
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", 42];
// 正确，将 42 封装成 NSNumber 类
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:42]];

 
 
线程安全
如果我们的 app 需要多线程操作数据库，那么就需要使用 FMDatabaseQueue 来保证线程安全了。 切记不能在多个线程中共同一个 FMDatabase 对象并且在多个线程中同时使用，这个类本身不是线程安全的，这样使用会造成数据混乱等问题。
使用 FMDatabaseQueue 很简单，首先用一个数据库文件地址来初使化 FMDatabaseQueue，然后就可以将一个闭包 (block) 传入 inDatabase 方法中。 在闭包中操作数据库，而不直接参与 FMDatabase 的管理。

 
 
  
  1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
// 创建，最好放在一个单例的类中
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;
    }
    // etc…
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:4]];
}];

 
 
工具
为了查看 Sqlite 中的数据，一个好的图形化界面的数据库管理程序是必不可少的。mysql 有 phpMyAdmin，那么 sqlite 呢？
我主要使用的是 Firefox 的一个名为 SQLite Manager 的插件，安装此插件后，可以直接打开后缀名为 sqlite 的数据库文件。SQLite Manager 提供一个图形化的界面来执行数据查询或更改操作。如下图所示：
总结
FMDB 将 SQLite API 进行了很友好的封装，使用上非常方便，对于那些使用纯 Sqlite API 来进行数据库操作的 app，可以考虑将其迁移到基于 FMDB 上，这对于以后数据库相关功能的开发维护，可以提高不少效率。
我在学习 fmdb 的时候做了一个小工程用于练习，我把它放到 github 上了。感兴趣的可以自行下载：https://github.com/tangqiaoboy/FmdbSample
 
 
  
  

 
 


FMDatabase 对SQLite 的API进行了很好的封装，使用起来很方便。
使用说明：https://github.com/ccgus/fmdb
（1)引入相关文件。
FMDatabase.h
FMDatabase.m
FMDatabaseAdditions.h
FMDatabaseAdditions.m
FMDatabasePool.h
FMDatabasePool.m
FMDatabaseQueue.h
FMDatabaseQueue.m
FMResultSet.h
FMResultSet.m
(2)应用
建立数据库
建立数据库只需要如下一行即可,当该文件不存在时，fmdb会自己创建一个。如果你传入的参数是空串：@”” ，则fmdb会在临时文件目录下创建这个数据库，如果你传入的参数是 NULL，则它会建立一个在内存中的数据库。
 
FMDatabase *db = [FMDatabase databaseWithPath:@"/tmp/tmp.db"];
 
打开数据库
使用如下语句，如果打开失败，可能是权限不足或者资源不足。通常打开完操作操作后，需要调用close方法来关闭数据库。
 
if (![db open]) {
    // error
    return;
}
// some operation
// ...
 
[db close];
 
执行更新操作
除了Select操作之外，其它的都是更新操作。更新操作使用如下方法，如果有错误，可以用error参数中获得。
 
 -[FMDatabase executeUpdate:error:withArgumentsInArray:orVAList:]
 
执行查询操作
查询操作示例如下。注意：即使操作结果只有一行，也需要先调用FMResultSet的next方法。
FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];
while ([s next]) {
    //retrieve values for each record
}
 
FMResultSet *s = [db executeQuery:@"SELECT COUNT(*) FROM myTable"];
if ([s next]) {
    int totalCount = [s intForColumnIndex:0];
}
 
 
FMDB提供如下多个方法来获取不同类型的数据：
 
intForColumn:
longForColumn:
longLongIntForColumn:
boolForColumn:
doubleForColumn:
stringForColumn:
dateForColumn:
dataForColumn:
dataNoCopyForColumn:
UTF8StringForColumnIndex:
objectForColumn:
 
通常情况下，你并不需要关闭FMResultSet，因为相关的数据库关闭时，FMResultSet也会被自动关闭。
 
数据参数
通常情况下，你可以按照标准的SQL语句，用?表示执行语句的参数，如：
 
 INSERT INTO myTable VALUES (?, ?, ?)
 
然后，可以我们可以调用executeUpdate方法来将?所指代的具体参数传入，通常是用变长参数来传递进去的，如下：
 
NSString *sql = @"insert into User (name, password) values (?, ?)";
[db executeUpdate:sql, user.name, user.password];
 
这里需要注意的是，参数必须是NSObject的子类，所以象int,double,bool这种基本类型，需要封装成对应的包装类才行，如下所示：
// 错误，42不能作为参数
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", 42];
// 正确，将42封装成 NSNumber 类
[db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:42]];
 
线程安全
如果我们的app需要多线程操作数据库，那么就需要使用FMDatabaseQueue来保证线程安全了。切记不能在多个线程中共同一个FMDatabase对象并且在多个线程中同时使用，这个类本身不是线程安全的，这样使用会造成数据混乱等问题。
 
使用FMDatabaseQueue很简单，首先用一个数据库文件地址来初使化FMDatabaseQueue，然后就可以将一个闭包(block)传入inDatabase方法中。在闭包中操作数据库，而不直接参与FMDatabase的管理。
 
// 创建，最好放在一个单例的类中
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;
    }
    // etc…
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", [NSNumber numberWithInt:4]];
}];

#import <Foundation/Foundation.h>
#import "FMDatabase.h"
#import "FMDatabaseAdditions.h"

@interface wiDBRoot : NSObject
@property (retain, nonatomic) FMDatabase *DB;
@property (retain, nonatomic) NSString *DBName;

//+ (id)modelWithDBName:(NSString *)dbName;
- (id)initWithDBName:(NSString *)dbName;
// 删除数据库
- (void)deleteDatabse;

// 数据库存储路径
//- (NSString *)getPath:(NSString *)dbName;
// 打开数据库
- (void)readyDatabse;

// 判断是否存在表
- (BOOL) isTableOK:(NSString *)tableName;
// 获得表的数据条数
- (BOOL) getTableItemCount:(NSString *)tableName;
// 创建表
- (BOOL) createTable:(NSString *)tableName withArguments:(NSString *)arguments;
// 删除表-彻底删除表
- (BOOL) deleteTable:(NSString *)tableName;
// 清除表-清数据
- (BOOL) eraseTable:(NSString *)tableName;
// 插入数据
- (BOOL)insertTable:(NSString*)sql, ...;
// 修改数据
- (BOOL)updateTable:(NSString*)sql, ...;

// 整型
- (NSInteger)getDb_Integerdata:(NSString *)tableName withFieldName:(NSString *)fieldName;
// 布尔型
- (BOOL)getDb_Booldata:(NSString *)tableName withFieldName:(NSString *)fieldName;
// 字符串型
- (NSString *)getDb_Stringdata:(NSString *)tableName withFieldName:(NSString *)fieldName;
// 二进制数据型
- (NSData *)getDb_Bolbdata:(NSString *)tableName withFieldName:(NSString *)fieldName;

@end

#import "wiDBRoot.h"

@interface wiDBRoot ()
- (NSString *)getPath:(NSString *)dbName;
@end

@implementation wiDBRoot
@synthesize DB;
@synthesize DBName;

/*
+ (id)modelWithDBName:(NSString *)dbName
{
    [[[self alloc] initWithDBName:dbName] autorelease];
    return self;
}
*/

- (id)initWithDBName:(NSString *)dbName
{

    self = [super init];

    if(nil != self)
    {
        DBName = [self getPath:dbName];
        WILog(@"DBName: %@", DBName);
    }

    return self;
}

- (void)dealloc {
    [DB close];
    [DB release];
    [DBName release];
    [super dealloc];
}

// 数据库存储路径(内部使用)
- (NSString *)getPath:(NSString *)dbName
{
    NSArray *paths = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES);
    NSString *documentsDirectory = [paths objectAtIndex:0];
    return [documentsDirectory stringByAppendingPathComponent:dbName];
}

// 打开数据库
- (void)readyDatabse
{
    //BOOL success;
    //NSError *error;

    //NSFileManager *fileManager = [NSFileManager defaultManager];
    //success = [fileManager fileExistsAtPath:self.DBName];

    if ([DB databaseExists])
        return;

    //DB = [FMDatabase databaseWithPath:DBName];
    DB = [[FMDatabase alloc] initWithPath:DBName];

    if (![DB open])
    {
		[DB close];
        NSAssert1(0, @"Failed to open database file with message '%@'.", [DB lastErrorMessage]);
    }

    // kind of experimentalish.
    [DB setShouldCacheStatements:YES];
}

#pragma mark 删除数据库
// 删除数据库
- (void)deleteDatabse
{
    BOOL success;
    NSError *error;

    NSFileManager *fileManager = [NSFileManager defaultManager];

    // delete the old db.
    if ([fileManager fileExistsAtPath:DBName])
    {
        [DB close];
        success = [fileManager removeItemAtPath:DBName error:&error];
        if (!success) {
            NSAssert1(0, @"Failed to delete old database file with message '%@'.", [error localizedDescription]);
        }
    }
}

// 判断是否存在表
- (BOOL) isTableOK:(NSString *)tableName
{
    FMResultSet *rs = [DB executeQuery:@"SELECT count(*) as 'count' FROM sqlite_master WHERE type ='table' and name = ?", tableName];
    while ([rs next])
    {
        // just print out what we've got in a number of formats.
        NSInteger count = [rs intForColumn:@"count"];
        WILog(@"isTableOK %d", count);

        if (0 == count)
        {
            return NO;
        }
        else
        {
            return YES;
        }
    }

    return NO;
}

// 获得表的数据条数
- (BOOL) getTableItemCount:(NSString *)tableName
{
    NSString *sqlstr = [NSString stringWithFormat:@"SELECT count(*) as 'count' FROM %@", tableName];
    FMResultSet *rs = [DB executeQuery:sqlstr];
    while ([rs next])
    {
        // just print out what we've got in a number of formats.
        NSInteger count = [rs intForColumn:@"count"];
        WILog(@"TableItemCount %d", count);

        return count;
    }

    return 0;
}

// 创建表
- (BOOL) createTable:(NSString *)tableName withArguments:(NSString *)arguments
{
    NSString *sqlstr = [NSString stringWithFormat:@"CREATE TABLE %@ (%@)", tableName, arguments];
    if (![DB executeUpdate:sqlstr])
    //if ([DB executeUpdate:@"create table user (name text, pass text)"] == nil)
    {
        WILog(@"Create db error!");
        return NO;
    }

    return YES;
}

// 删除表
- (BOOL) deleteTable:(NSString *)tableName
{
    NSString *sqlstr = [NSString stringWithFormat:@"DROP TABLE %@", tableName];
    if (![DB executeUpdate:sqlstr])
    {
        WILog(@"Delete table error!");
        return NO;
    }

    return YES;
}

// 清除表
- (BOOL) eraseTable:(NSString *)tableName
{
    NSString *sqlstr = [NSString stringWithFormat:@"DELETE FROM %@", tableName];
    if (![DB executeUpdate:sqlstr])
    {
        WILog(@"Erase table error!");
        return NO;
        }

    return YES;
    }

// 插入数据
- (BOOL)insertTable:(NSString*)sql, ...
{
    va_list args;
    va_start(args, sql);

    BOOL result = [DB executeUpdate:sql error:nil withArgumentsInArray:nil orVAList:args];

    va_end(args);
    return result;
}

// 修改数据
- (BOOL)updateTable:(NSString*)sql, ...
{
    va_list args;
    va_start(args, sql);

    BOOL result = [DB executeUpdate:sql error:nil withArgumentsInArray:nil orVAList:args];

    va_end(args);
    return result;
}

// 暂时无用
#pragma mark 获得单一数据

// 整型
- (NSInteger)getDb_Integerdata:(NSString *)tableName withFieldName:(NSString *)fieldName
{
    NSInteger result = NO;

    NSString *sql = [NSString stringWithFormat:@"SELECT %@ FROM %@", fieldName, tableName];
    FMResultSet *rs = [DB executeQuery:sql];
    if ([rs next])
        result = [rs intForColumnIndex:0];
    [rs close];

    return result;
}

// 布尔型
- (BOOL)getDb_Booldata:(NSString *)tableName withFieldName:(NSString *)fieldName
{
    BOOL result;

    result = [self getDb_Integerdata:tableName withFieldName:fieldName];

    return result;
}

// 字符串型
- (NSString *)getDb_Stringdata:(NSString *)tableName withFieldName:(NSString *)fieldName
{
    NSString *result = NO;

    NSString *sql = [NSString stringWithFormat:@"SELECT %@ FROM %@", fieldName, tableName];
    FMResultSet *rs = [DB executeQuery:sql];
    if ([rs next])
        result = [rs stringForColumnIndex:0];
    [rs close];

    return result;
}

// 二进制数据型
- (NSData *)getDb_Bolbdata:(NSString *)tableName withFieldName:(NSString *)fieldName
{
    NSData *result = NO;

    NSString *sql = [NSString stringWithFormat:@"SELECT %@ FROM %@", fieldName, tableName];
    FMResultSet *rs = [DB executeQuery:sql];
    if ([rs next])
        result = [rs dataForColumnIndex:0];
    [rs close];

    return result;
}

@end

空中海

关注

0
点赞
踩
0

收藏

觉得还不错? 一键收藏
0
评论
FMDatabase的一些基本操作小结

#import #import "FMDatabase.h"#import "FMDatabaseAdditions.h"@interface wiDBRoot : NSObject@property (retain, nonatomic) FMDatabase *DB;@property (retain, nonatomic) NSString *DBName;//+ (id)m
复制链接

扫一扫