FMDB的基本使用

类

FMDB中有三个常用的类：

1. FMDatabase 表示一个SQLite数据库，用来执行SQL语句。
2. FMResultSet 表示FMDatase 执行查询语句后的结果。
3. FMDatabaseQueue 当你需要在多线程中执行queries或updates时，需要使用这个类，它是线程安全的。

创建数据库

创建一个数据库FMDatabase 需要一个存储数据库的路径，这个路径可以是一下三种之一：

1. 一个系统文件路径。当这个这个路径不存在database文件时，FMDB会为你创建一个。
2. 一个空字符串@""。此时FMDB会在临时路径tmp 创建一个空的database，当FMDatabase 的connection 被 closed的时候，它会被删除。
3. NULL。FMDB会在内存中创建一个database，同样的，当它的connection closed的时候会被删除。

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

打开数据库

在你跟数据库交互前，必须先打开它，当存储空间不足或者没有权限时，会打开失败。

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

数据更新 Executing Updates

所有不是SELECT 的语句都被视为update，这其中包括CREATE、UPDATE、INSERT、ALTER、COMMIT、BEGIN、DETACH、DELETE、DROP、END、EXPLAIN、VACUUM 和REPLACE 等语句。基本上，如果你的SQL语句不是以SELECT 开头，就是一个update语句。

database执行updates会返回一个布尔值来表示是否成功，当是执行失败时，可以调用-lastErrorMessage 和 -lastErrorCode 方法来获取错误信息。

数据查询 Executing Queries

使用任何一个-executeQuery... 系列的方法执行SELECT 语句，被视为数据查询。

数据查询方法成功会返回一个FMResultSet 对象，失败时为nil。同样可以调用-lastErrorMessage 和 -lastErrorCode 方法来获取错误信息。

你可以用一个while 循环来遍历所有的查询结果：

FMResultSet *s = [db executeQuery:@"SELECT * FROM myTable"];
while ( [s next] ) {
    // 获取数据
}

在获取查询结果的数据前，都应该调用-next 方法，及时你确定获取的结果只有一个

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

FMResultSet 针对不同类型的数据有对应的数据获取方法：

• intForColumn:
• longForColumn:
• longLongIntForColumn:
• boolForColumn:
• doubleForColumn:
• stringForColumn:
• dateForColumn:
• dataForColumn:
• dataNoCopyForColumn:
• UTF8StringForColumnName:
  所有的这些方法都有一个{type}ForColumnIndex: 方法，用columnIndex来获取数据。
  FMResultSet 并不需要手动去close，当对象被释放时会自动被close。

关闭数据库

当完成相关的操作后，应该调用-close 方法来关闭FMDatabase 的connection，让SQLite释放资源。

[db close];

事务处理(Transactions)

FMDatabase 可以通过调用相关的方法来进行事务处理。

多语句和批量任务

我们可以调用FMDatabase 的executeStatements: 、 -executeStatements: withResultBlock: 方法来执行多个SQL语句：

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;
}];

数据消毒(Data Sanitization)

编写SQL语句时，应该使用? 作为变量值的占位符，? 是可以被SQLite识别的字符：

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

FMDatabase 的执行方法可以接受多个参数，也可以调用下面的方法使用NSArray、NSDictionary等集合来表示这些参数。

- (BOOL)executeUpdate:(NSString*)sql withParameterDictionary:(NSDictionary *)arguments;

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

NSInteger identifier = 42;
NSString *name = @"Liam O'Flahery(\"the famous Irish author\")";
NSDate *date = [NSDate date];
NSString *comment = nil;

Bool success = [db executeUpdate:@"INSERT INTO authors (identifier, name, date, comment) VALUES (?, ?, ?, ?)", @(identifier), name, date, comment?:[NSNull null] ];
if (!success) {
    NSLog(@"error: %@", [db lastErrorMessage]);
}

*NOTE：基本数据类型，如NSInteger 应该包装成NSNumber ，当对象可能是nil空时，应该使用[NSNull null] *

Swift 版本：

do {
    let identifier = 42
    let name = "Liam O'Flaherty (\"the famous Irish author\")"
    let date = NSDate()
    let comment: String? = nil

    try db.executeUpdate("INSERT INTO authors (identifier, name, date, comment) VALUES (?, ?, ?, ?)", values: [identifier, name, date, comment ?? NSNull()])
} catch {
    print("error = \(error)")
}

在swift中，基本数据不再需要包装成Number，但是在如果插入数据是可选型时，可以使用comment ?? NSNull() 类似的语法来防止插入nil。

也可以使用命名参数语法：
INSERT INTO authors (identifier, name, date, comment) VALUES (:identifier, :name, :date, :comment)
SQL语句中的 VALUES 后带的参数必须以冒号开头，而不要在字典中使用冒号开头的key。

NSDictionary *arguments = @{ @"identifier" : @identifier, @"name" : name, @"date": date, @"comment" : comment?:[NSNull null] };
success = [db executeUpdate:@"INSERT INTO authors (identifier, name, date, comment) VALUES (:identifier, :name:, :date, :comment" withParameterInDictionary:arguments];
if (!success) {
    NSLog(@"error:%@", [db lastErrorMessage]);
}

使用FMDatabaseQueue和线程安全

不要在多个线程中使用同一个FMDatabase 对象，很容易造成程序崩溃。在每个线程中去创建FMDatabase 对象是可以的。

可以使用FMDatabaseQueue 对象，可以创建一个FMDatabaseQueue 对象，并且在多个线程中共用，因为它是线程安全的。怎么使用FMDatabaseQueue :
首先创建你的队列：

FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath: aPath];

然后像这样使用它：

[queue inDatabase:^(FMDatabase *db) {
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @1];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @2];
    [db executeUpdate:@"INSERT INTO myTable VALUES (?)", @3];
    FMResultSet *rs = [db executeQuery:@"select * from foo"];
    while ( [rs next] ) {
        // 获取数据...
    }
}];

把多个语句包含在事务处理中也很简单：

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

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

Swift ：

queue.inTransaction { db, rollback in
    do {
        try db.executeUpdate("INSERT INTO myTable VALUES (?)", values: [1])
        try db.executeUpdate("INSERT INTO myTable VALUES (?)", values: [2])
        try db.executeUpdate("INSERT INTO myTable VALUES (?)", values: [3])

        if whoopsSomethingWrongHappened {
            rollback.memory = true
            return
        }

        try db.executeUpdate("INSERT INTO myTable VALUES (?)", values: [4])
    } catch {
        rollback.memory = true
        print(error)
    }
}

常用SQL语句

1.创建表

语法：
create table table_name (field1 type1, field2 type2, field3 type3...);
在SQLite3中可以不指定字段的数据类型，SQLite3会自动推断类型。常用的格式有：
文本： Text
整形： Integer
二进制数据: Blob
浮点型： Real Float、Double
布尔型： Boolean
时间型： Time
日期型： Date
时间戳： TimeStamp

示例代码：

NSString *createStatement = @"create table testTable (id integer primary key autoincrement, name text, length integer, year integer, actor text);"

字段可以添加约束：

• 主键：primary key。主键的值必须唯一，用于标识每一条记录，如学生的学号；主键同时也是一个索引，通过主键查找记录速度较快；主键如果是整数类型，该列的值可以自动增长；
• 自增：autoincrement
• 非空：Not Null。字段值不能为空，否则报错。
• 唯一：Unique。约束此字段值唯一。主键默认唯一。
• 条件检查：Check。该字段值必须符合条件才能存入。
• 默认值：Default。

2.增加数据

语法：
INSERT INTO table_name (field1, field2...) VALUES (var1, var2...);

示例代码

NSString *insertStatement = @"insert into student (stu_no, name) values (1, 'Jack')";
BOOL success = [db executeStatements:insertStatement];

3.更改数据

语法：
update table_name set field1 = var1, field2 = var2 where expression;
所有符合 where 条件的数据都会被更改。

示例代码：

NSString *updateStatement = @"update stuendt_info set stu_no = 0003, name = 'Merry' where stu_no = 0001;";
BOOL success = [db executeUpdate:updateStatement];

3.删除

语法：
delete from table_name where expression;
删除所有符合条件的数据，不设置条件时清空所有数据。

示例代码：

NSString *deleteStatement = @"delete from student_info where stu_no = 0001;";
BOOL success = [db executeUpdate:deleteStatement];

4.查询

// 选中所有
    NSString *select = @"select * from film;";
    FMResultSet *rs = [db executeQuery:select];
    
    // 选中前2个
    select = @"select * from film limit 2;";
    rs = [db executeQuery:select];
    
    // 选中几个column
    select = @"select name,length from film limit 2;";
    rs = [db executeQuery:select];
    
    // 排序 (默认升序，desc 倒序)
    select = @"select * from film order by length desc limit 3";
    rs = [db executeQuery:select];
    
    // 指定column值
    select = @"select *from film where actor = 'Malanie Y'";
    rs = [db executeQuery:select];
    
    // 指定column开头, like, %是SQL中的通用符
    select = @"select * from film where actor like 'J%'";
    rs = [db executeQuery:select];
    
    // 组合条件, 用and、or连接
    select = @"select * from film where length >= 118 and year > 2010 and actor like 'M%';";
    rs = [db executeQuery:select];
    
    select = @"select *from film where length >= 120 or year >= 2016;";
    rs = [db executeQuery:select];
    
    // 表的数据量，有多少行, 取resultset的第0个column值就是rowCount
    select = @"select count(*) from film;";
    rs = [db executeQuery:select];
    
    select = @"select count(*) from film where actor like 'J%'";
    rs = [db executeQuery:select];