FMDB使用

发表于 分类于

FMDB以OC的方式封装了SQLite的C语言API。所以相对使用底层语言实现的Sqlite来说，FMDB主要有以下优点：

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

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

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

FMDB有三个主要的类：

  1. FMDatabase

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

  2. FMResultSet

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

  3. FMDatabaseQueue

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

创建或打开数据库

1
2
3
4
FMDatabase *db = [FMDatabase databaseWithPath:path];
if (![db open]) {
    NSLog(@"数据库打开失败！");
}

空字符串@"" 会在临时目录创建一个空的数据库。当FMDatabase连接关闭时，数据库文件也被删除。

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

执行更新

  1. 在FMDB中，除查询以外的所有操作，都称为“更新”：create、drop、insert、update、delete等。

  2. 使用executeUpdate:方法执行更新：

    1
    2
    3
    - (BOOL)executeUpdate:(NSString*)sql, ...
    - (BOOL)executeUpdateWithFormat:(NSString*)format, ...
    - (BOOL)executeUpdate:(NSString*)sql withArgumentsInArray:(NSArray *)arguments

    示例

    FMDB中SQL语句字符串不需要加’’:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    //插入数据

    [db executeUpdate:@"insert into test (a, b, c, d, e) values (?, ?, ?, ?, ?)" ,@"hi'", // look!  I put in a ', and I'm not escaping it!
           [NSString stringWithFormat:@"number %d", i],
           [NSNumber numberWithInt:i],
           [NSDate date],
           [NSNumber numberWithFloat:2.2f]];
     ];
    //更新数据
    [db executeUpdate:@"UPDATE t_student SET age = ? WHERE name = ?;", @20, @"Jack"];

执行查询

  1. 查询方法
1
2
3
- (FMResultSet *)executeQuery:(NSString*)sql, ...
- (FMResultSet *)executeQueryWithFormat:(NSString*)format, ...
- (FMResultSet *)executeQuery:(NSString *)sql withArgumentsInArray:(NSArray *)arguments
  1. 遍历结果集
1
2
3
4
5
6
7
8
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. 模糊查询

    查询语句中%%xxx%%代表包含xx字段，x%代表xx开头字段，%x代表xx结尾字段。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
+(NSArray*)queryFuzzyContactInfo:(NSString *)item
{
    FMDatabase *database = [FMDatabase databaseWithPath:SQLITEPATH1];
    if (![database open]) {
        NSLog(@"数据库打开失败");
    }
    
    NSMutableArray *array = [NSMutableArray arrayWithCapacity:0];
    
    FMResultSet *resultSet = [database executeQuery:@"select * from mysql1 WHERE name like '%%%@%%'",item];
    while ([resultSet next])
    {
        NSString * name = [resultSet stringForColumn:@"name"];
    }
    return array;
}

多线程异步执行多次数据操作

FMDatabase这个类是线程不安全的，如果在多个线程中同时使用一个FMDatabase实例，会造成数据混乱等问题。

为了保证线程安全，FMDB提供方便快捷的FMDatabaseQueue类。

  1. FMDatabaseQueue的创建:

    1
    FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:path];

  2. 简单使用

    1
    2
    3
    4
    5
    6
    7
    8
    9
    [queue inDatabase:^(FMDatabase *db) {
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Jack"];
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Rose"];
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Jim"];
        FMResultSet *rs = [db executeQuery:@"select * from t_student"];
        while ([rs next]) {
            // …
        }
    }];

  3. 使用事务

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    [queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Jack"];
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Rose"];
        [db executeUpdate:@"INSERT INTO t_student(name) VALUES (?)", @"Jim"];
        FMResultSet *rs = [db executeQuery:@"select * from t_student"];
        while ([rs next]) {
            // …
        }
    }];
    /*事务回滚*/
    *rollback = YES;