您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 程式開發 >> iOS 開發綜合

iOS 開發:用 FMDB 讓 App 連接 SQLite 資料庫

編輯:iOS 開發綜合

一、FMDB 是什麼

FMDB 是 iOS 平台上針對 SQLite 的封裝框架,本質上就是把 SQLite 的 C 語言 API 用 Objective-C 的方式重新包裝了一層。

它的好處很直接:

1. 更物件導向,省下大量繁瑣、重複的 C 語言程式碼;
2. 相較於蘋果自帶的 Core Data,更輕量、更靈活;
3. 提供多執行緒安全的資料庫操作方式,能有效避免資料混亂。

專案地址:
https://github.com/ccgus/fmdb

二、三個核心類別

(1)FMDatabase:一個 FMDatabase 物件代表一個獨立的 SQLite 資料庫,用來執行 SQL 語句。
(2)FMResultSet:執行查詢後得到的結果集。
(3)FMDatabaseQueue:用於多執行緒環境下執行多個查詢或更新,天生執行緒安全。

三、開啟資料庫

只要給定 SQLite 檔案路徑,就能建立 FMDatabase 物件:

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

路徑有三種常見寫法:

(1)具體檔案路徑:若檔案不存在會自動建立。
(2)空字串 @"":會在暫存目錄建立一個空的資料庫,連線關閉時檔案一併刪除。
(3)nil:建立記憶體中的臨時資料庫,連線關閉時資料庫即銷毀。

四、執行更新

在 FMDB 的用語裡,除了查詢以外的操作都叫「更新」,包含 create、drop、insert、update、delete 等。

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

六、完整程式碼示例

第一步,建立專案並匯入 libsqlite3 函式庫,同時加入主標頭檔:

第二步,下載第三方框架 FMDB:

第三步,撰寫程式碼:

#import "YYViewController.h"
#import "FMDB.h"

@interface YYViewController ()
@property (nonatomic, strong) FMDatabase *db;
@end

@implementation YYViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    // 1. 取得資料庫檔案路徑
    NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    NSString *fileName = [doc stringByAppendingPathComponent:@"student.sqlite"];

    // 2. 取得資料庫
    FMDatabase *db = [FMDatabase databaseWithPath:fileName];

    // 3. 開啟資料庫
    if ([db open]) {
        // 4. 建表
        BOOL result = [db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
        if (result) {
            NSLog(@"建表成功");
        } else {
            NSLog(@"建表失敗");
        }
    }
    self.db = db;
}

- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {
    [self delete];
    [self insert];
    [self query];
}

// 插入資料
- (void)insert {
    for (int i = 0; i < 10; i++) {
        NSString *name = [NSString stringWithFormat:@"jack-%d", arc4random_uniform(100)];
        // 不確定的參數用 ? 佔位
        [self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);", name, @(arc4random_uniform(40))];

        // 也可以改用 withArgumentsInArray
        // [self.db executeUpdate:@"INSERT INTO t_student (name, age) VALUES (?, ?);" withArgumentsInArray:@[name, @(arc4random_uniform(40))]];

        // executeUpdateWithFormat 則用 %@、%d 佔位
        // [self.db executeUpdateWithFormat:@"INSERT INTO t_student (name, age) VALUES (%@, %d);", name, arc4random_uniform(40)];
    }
}

// 清空資料
- (void)delete {
    [self.db executeUpdate:@"DROP TABLE IF EXISTS t_student;"];
    [self.db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_student (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
}

// 查詢
- (void)query {
    FMResultSet *resultSet = [self.db executeQuery:@"SELECT * FROM t_student"];
    while ([resultSet next]) {
        int ID = [resultSet intForColumn:@"id"];
        NSString *name = [resultSet stringForColumn:@"name"];
        int age = [resultSet intForColumn:@"age"];
        NSLog(@"%d %@ %d", ID, name, age);
    }
}

@end

執行結果:

小提醒:如果 id 設為 autoincrement,把表裡的資料刪掉之後再插入新資料,id 不會從 0 重新開始,而是接著原本的號碼繼續編號。

另外要注意寫法,佔位符不要加上單引號,直接用 %@ 即可,FMDB 會自動判斷為字串:

七、FMDatabaseQueue 資料庫佇列

(1)一樣需要先匯入 FMDB 框架與標頭檔;由於它依賴 libsqlite,這個函式庫也要一併匯入。

(2)程式碼如下:

#import "YYViewController.h"
#import "FMDB.h"

@interface YYViewController ()
@property (nonatomic, strong) FMDatabaseQueue *queue;
@end

@implementation YYViewController

- (void)viewDidLoad {
    [super viewDidLoad];

    // 1. 取得資料庫檔案路徑
    NSString *doc = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    NSString *fileName = [doc stringByAppendingPathComponent:@"person.sqlite"];

    // 2. 取得資料庫佇列
    FMDatabaseQueue *queue = [FMDatabaseQueue databaseQueueWithPath:fileName];

    // 3. 透過佇列操作資料庫
    [queue inDatabase:^(FMDatabase *db) {
        BOOL result = [db executeUpdate:@"CREATE TABLE IF NOT EXISTS t_person (id integer PRIMARY KEY AUTOINCREMENT, name text NOT NULL, age integer NOT NULL);"];
        if (result) {
            NSLog(@"建表成功");
        } else {
            NSLog(@"建表失敗");
        }
    }];
    self.queue = queue;
}

- (void)touchesBegan:(NSSet *)touches withEvent:(UIEvent *)event {
    // 查詢資料
    [self.queue inDatabase:^(FMDatabase *db) {
        FMResultSet *resultSet = [db executeQuery:@"SELECT * FROM t_person"];
        while ([resultSet next]) {
            int ID = [resultSet intForColumn:@"id"];
            NSString *name = [resultSet stringForColumn:@"name"];
            int age = [resultSet intForColumn:@"age"];
            NSLog(@"%d %@ %d", ID, name, age);
        }
    }];
}

@end

先插入資料再查詢,輸出如下:

(3)觀念說明:有了佇列物件之後,它內部會自動持有資料庫物件,而且所有操作都是執行緒安全的。

八、事務(Transaction)

以轉帳為例最容易理解:

張三和李四帳戶裡各有 1000 元,張三要轉帳給李四需要執行兩條 SQL。基於安全性考量,這兩條語句必須「要嘛全部成功,要嘛全部失敗」。事務就是把多條語句包在同一個交易裡,中途出錯就自動回滾,這也是所謂的原子性。

做法一:手動 beginTransaction / commit

[self.queue inDatabase:^(FMDatabase *db) {
    [db beginTransaction];
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @23];
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @24];
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @25];
    [db commit];
}];

中途出問題時會自動回滾,也可以選擇手動回滾:

[self.queue inDatabase:^(FMDatabase *db) {
    [db beginTransaction];
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @23];
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @24];
    [db rollback];
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @25];
    [db commit];
}];

上面這段程式碼裡,前三條插入語句因為 rollback 而全部作廢。

做法二:使用 inTransaction,由系統自動開啟與提交事務:

[self.queue inTransaction:^(FMDatabase *db, BOOL *rollback) {
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @23];
    [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @24];
}];

它的流程是:先開啟事務,執行 block 中的程式碼,最後提交事務;若將 rollback 設為 YES 即可回滾。這種寫法比手動管理更簡潔,也比較不容易漏掉 commit。

  1. 上一篇文章:
  2. 下一篇文章:
蘋果刷機越獄教程| IOS教程問題解答| IOS技巧綜合| IOS7技巧| IOS8教程
Copyright © IOS教程網 All Rights Reserved