您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 教學 >> iOS 相關教學

iOS 資料持久化:用 FMDB 讓 App 直連 SQLite 資料庫

編輯:iOS 相關教學

一、FMDB 是什麼

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

它解決了什麼問題?

原生 SQLite 的 C API 寫起來繁瑣且容易出錯:語句要自己拼、參數要綁定、結果集要一欄一欄取值。FMDB 讓整個過程變得物件導向,省下大量冗餘的 C 程式碼。

相較於 Apple 自帶的 Core Data,FMDB 更輕量、更靈活,SQL 語句全由你掌控。

此外,它還提供了多線程安全的資料庫操作方式,能有效避免資料錯亂。

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

二、三個核心類別

FMDatabase:一個 FMDatabase 物件代表一個獨立的 SQLite 資料庫,所有 SQL 語句都透過它執行。

FMResultSet:執行查詢後得到的結果集,用 next 逐列遍歷。

FMDatabaseQueue:用於在多線程環境中執行多個查詢或更新,它天生是線程安全的。

三、打開資料庫

透過指定 SQLite 檔案路徑來建立 FMDatabase 物件:

FMDatabase *db = [FMDatabase databaseWithPath:path];

if (![db open]) {
    NSLog(@"資料庫打開失敗!");
}

路徑有三種常見情形:

  1. 具體檔案路徑:檔案不存在時會自動建立。
  2. 空字串 @"":會在臨時目錄建立一個空的資料庫,當 FMDatabase 連線關閉時,檔案也會被刪除。
  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"];

用 ? 作為參數佔位符,能有效避免拼接字串造成的 SQL 注入風險。

五、執行查詢

- (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:

//
//  YYViewController.m
//  04-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)];

        // executeUpdate: 不確定的參數用 ? 佔位
        [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:@"DELETE FROM t_student;"];
    [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
{
    // 1. 執行查詢語句
    FMResultSet *resultSet = [self.db executeQuery:@"SELECT * FROM t_student"];

    // 2. 遍歷結果
    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 並不會從 1 重新開始,而是接續先前的最大值遞增。

要注意:使用 executeUpdateWithFormat: 時,字串參數請直接寫 %@,不要自己加上單引號。

七、FMDB 資料庫隊列

同樣需要先導入 FMDB 框架與標頭檔;由於它依賴 libsqlite 庫,這個庫也要一併加入。

//
//  YYViewController.m
//  05-FMDB資料庫隊列
//
#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) {
    //     [db executeUpdate:@"INSERT INTO t_person (name, age) VALUES (?, ?);", @"wendingding", @22];
    // }];

    // 查詢資料
    [self.queue inDatabase:^(FMDatabase *db) {
        // 1. 執行查詢語句
        FMResultSet *resultSet = [db executeQuery:@"SELECT * FROM t_person"];

        // 2. 遍歷結果
        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

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

隊列帶來的好處。有了隊列物件之後,它內部會自動持有並管理一個資料庫物件,而且所有操作都是線程安全的。

事務處理

沒有事務機制,某些操作會出問題。最經典的例子是銀行轉帳:

張三和李四帳戶都有 1000 塊錢。張三要轉帳給李四,需要執行兩條 SQL。基於安全性考量,這兩條語句要嘛全部成功,要嘛全部失敗——絕不能出現「錢扣了但沒入帳」的狀態。

事務就是把多條語句綁在同一個單元裡執行,要嘛全成功,要嘛全失敗;中途出問題時會自動回滾。這特性稱為原子性。

把多條語句放進同一個事務:

// 插入資料
[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];
}];

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

事務還有另一種更簡潔的寫法:

[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 會自動幫你開啟事務、執行其中的程式碼,最後提交事務,省去手寫 beginTransaction 與 commit 的麻煩。

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