FMDatabase一些基本操作

来源:互联网 发布:知乎提问有什么话题 编辑:程序博客网 时间:2024/04/30 04:18

由于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 @end15 16 @implementation YYViewController17 18 - (void)viewDidLoad19 {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         }else35         {36             NSLog(@"创表失败");37         }38     }39     self.db=db;40 41 }42 43 -(void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event44 {45     [self delete];46     [self insert];47     [self query];48 }49 50 //插入数据51 -(void)insert52 {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)delete66 {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)query74 {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 在使用上相当方便。以下是一个简单的例子:

1234567891011
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 到你的工程中:

12345678910
FMDatabase.hFMDatabase.mFMDatabaseAdditions.hFMDatabaseAdditions.mFMDatabasePool.hFMDatabasePool.mFMDatabaseQueue.hFMDatabaseQueue.mFMResultSet.hFMResultSet.m

建立数据库

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

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

打开数据库

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

12345678
if (![db open]) {    // error     return;}// some operation// ...[db close];

执行更新操作

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

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

执行查询操作

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

123456789
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 提供如下多个方法来获取不同类型的数据:

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

通常情况下,你并不需要关闭 FMResultSet,因为相关的数据库关闭时,FMResultSet 也会被自动关闭。

数据参数

通常情况下,你可以按照标准的 SQL 语句,用 ? 表示执行语句的参数,如:

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

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

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

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

1234
// 错误,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 的管理。

12345678910111213141516171819202122232425262728
// 创建,最好放在一个单例的类中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

.m

#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
原创粉丝点击