IOS開發之sqlite框架FMDB

Corwien發表於2016-07-02

FMDB框架用來操作sqlite非常方便,下面將詳細介紹該用法

一. 什麼是FMDB?

FMDB是iOS平臺的SQLite資料庫框架
FMDB以OC的方式封裝了SQLite的C語言API

FMDB的優點

  1. 使用起來更加物件導向,省去了很多麻煩、冗餘的C語言程式碼.

  2. 對比蘋果自帶的Core Data框架,更加輕量級和靈活

  3. 提供了多執行緒安全的資料庫操作方法,有效地防止資料混亂

FMDB的github地址

https://github.com/ccgus/fmdb

FMDB有三個主要的類

FMDatabase
一個FMDatabase物件就代表一個單獨的SQLite資料庫
用來執行SQL語句

FMResultSet
使用FMDatabase執行查詢後的結果集

FMDatabaseQueue
用於在多執行緒中執行多個查詢或更新,它是執行緒安全的

二. FMDB使用

1. 開啟資料庫

通過指定SQLite資料庫檔案路徑來建立FMDatabase物件

FMDatabase *db = [FMDatabase databaseWithPath:path];
if (![db open]) {
    NSLog(@"資料庫開啟失敗!");
}

檔案路徑有三種情況

  • 具體檔案路徑
    如果不存在會自動建立

  • 空字串@””
    會在臨時目錄建立一個空的資料庫, 當FMDatabase連線關閉時,資料庫檔案也被刪除

  • nil
    會建立一個記憶體中臨時資料庫,當FMDatabase連線關閉時,資料庫會被銷燬

2. 執行更新

1> 在FMDB中,除查詢以外的所有操作,都稱為“更新”
create、drop、insert、update、delete等

2> 使用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"]

3. 執行查詢

1> 查詢方法

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

4.FMDatabaseQueue

FMDatabase這個類是執行緒不安全的,如果在多個執行緒中同時使用一個FMDatabase例項,會造成資料混亂等問題

為了保證執行緒安全,FMDB提供方便快捷的FMDatabaseQueue類

FMDatabaseQueue的建立:

FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:path];

簡單使用:

[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]) {
        // …
    }
}];

使用事務
為保證多個操作同時成功或失敗,則使用事務,如銀行轉賬。

基本操作方法:

// 開啟事務
[db executeUpdate:@"begin transaction;"];

// 回滾事務
[db executeUpdate:@"rollback transaction;"];

// 提交事務
[db executeUpdate:@"commit transaction;"];

示例:
封裝好的事務操作:

[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;

相關文章