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,这其中包括CREATEUPDATEINSERTALTERCOMMITBEGINDETACHDELETEDROPENDEXPLAINVACUUMREPLACE 等语句。基本上,如果你的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 可以通过调用相关的方法来进行事务处理。

多语句和批量任务

我们可以调用FMDatabaseexecuteStatements:-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 FloatDouble
布尔型: 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];

你可能感兴趣的:(FMDB使用)