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

iOS 開發中的 SQLite:從 C API 到 Objective-C 封裝

編輯:iOS 開發綜合

SQLite 是什麼

SQLite 是一款輕量級的嵌入式資料庫,Android 與 iOS 平台採用的是同一套引擎。它的資源佔用極低,在嵌入式環境下往往只要幾百 KB 記憶體就足夠;處理速度相對於 MySQL、PostgreSQL 這類大型關聯式資料庫也毫不遜色。由於以 C 語言實作,跨平台能力很強,幾乎所有主流系統都能見到它的身影。

在 iOS 專案中導入 libsqlite3

要在 iOS 中使用 SQLite3,需要在 Xcode 專案的 Link Binary With Libraries 中加入 libsqlite3:

常用 SQL 語句回顧

建立資料表:create table 表名 (欄位1, 欄位2, ......, 欄位n, [表級約束]);
插入記錄:  insert into 表名 (欄位1, ......, 欄位n) values (值1, ......, 值n);
刪除記錄:  delete from 表名 where 條件運算式;
修改記錄:  update 表名 set 欄位1=值1, ......, 欄位n=值n where 條件運算式;
查詢記錄:  select 欄位1, ......, 欄位n from 表名 where 條件運算式;

核心 C API

開啟資料庫

int sqlite3_open(const char *filename,  /* 資料庫路徑(UTF-8) */
                 sqlite3 **pDb);        /* 回傳的資料庫 handle */

執行有回傳結果的 SQL(查詢)

int sqlite3_prepare_v2(sqlite3 *db,          /* 資料庫 handle */
                       const char *zSql,     /* SQL 語句(UTF-8) */
                       int nByte,            /* SQL 最大長度,-1 代表自動 */
                       sqlite3_stmt **ppStmt,/* 回傳的 statement */
                       const char **pzTail); /* 回傳未解析的殘餘字串 */

執行無回傳結果的 SQL(新增、刪除、修改)

int sqlite3_exec(sqlite3 *db,                       /* 資料庫 handle */
                 const char *sql,                   /* SQL 語句(UTF-8) */
                 int (*callback)(void*,int,char**,char**), /* 回呼函式 */
                 void *arg,                         /* 回呼函式第一個參數 */
                 char **errmsg);                    /* 回傳錯誤訊息 */

關閉資料庫

int sqlite3_close(sqlite3 *db);

實作範例

以下以微博介面回傳的資料為例,先定義一個資料模型。

DataModel.h

#import <Foundation/Foundation.h>

@interface DataModel : NSObject
@property (nonatomic, copy) NSString *screen_name;
@property (nonatomic, copy) NSString *avatar_hd;
- (instancetype)initWithDictionary:(NSDictionary *)dictionary;
@end

DataModel.m

#import "DataModel.h"

@implementation DataModel
- (instancetype)initWithDictionary:(NSDictionary *)dictionary {
    if (self = [super init]) {
        // 屬性很多時逐一賦值太繁瑣,一行 KVC 就能搞定
        [self setValuesForKeysWithDictionary:dictionary];
    }
    return self;
}
// 介面回傳的欄位往往比我們用得到的多,遇到用不到的 key 就靜靜忽略,避免報錯
- (void)setValue:(id)value forUndefinedKey:(NSString *)key {
    NSLog(@"%@", key);
}
@end

DataBase.h

#import <Foundation/Foundation.h>
#import "DataModel.h"

@interface DataBase : NSObject
+ (void)openDB;                              // 開啟
+ (NSArray *)find;                           // 查
+ (BOOL)insertModel:(DataModel *)dataModel;  // 增
+ (BOOL)deleteModel:(DataModel *)dataModel;  // 刪
@end

DataBase.m

#import "DataBase.h"
#import <sqlite3.h>

@implementation DataBase

static sqlite3 *db;

#pragma mark - 開啟資料庫
+ (void)openDB {
    // 把預先建立好的資料庫從 bundle 搬到 Documents,才能寫入
    NSString *originPath = [[NSBundle mainBundle] pathForResource:@"WeiBo" ofType:@"sqlite"];
    NSString *targetPath = [[NSSearchPathForDirectoriesInDomains(NSDocumentDirectory,
                            NSUserDomainMask, YES) objectAtIndex:0]
                            stringByAppendingPathComponent:@"collection.sqlite"];
    NSFileManager *manager = [NSFileManager defaultManager];
    if (![manager fileExistsAtPath:targetPath]) {
        [manager moveItemAtPath:originPath toPath:targetPath error:nil];
    }
    int result = sqlite3_open((const char *)[targetPath UTF8String], &db);
    NSLog(result == SQLITE_OK ? @"資料庫開啟成功" : @"資料庫開啟失敗");
}

#pragma mark - 查
+ (NSArray *)find {
    NSMutableArray *mArray = [NSMutableArray array];
    [self openDB];
    sqlite3_stmt *stmt = nil;
    const char *sql = "select * from weiBo";
    if (sqlite3_prepare_v2(db, sql, -1, &stmt, nil) == SQLITE_OK) {
        while (sqlite3_step(stmt) == SQLITE_ROW) {
            const char *screen_name = (const char *)sqlite3_column_text(stmt, 0);
            const char *avatar_hd   = (const char *)sqlite3_column_text(stmt, 1);
            DataModel *model = [[DataModel alloc] init];
            model.screen_name = [NSString stringWithCString:screen_name encoding:NSUTF8StringEncoding];
            model.avatar_hd   = [NSString stringWithCString:avatar_hd encoding:NSUTF8StringEncoding];
            [mArray addObject:model];
        }
    }
    return mArray;
}

#pragma mark - 增
+ (BOOL)insertModel:(DataModel *)dataModel {
    BOOL flag = NO;
    [self openDB];
    sqlite3_stmt *stmt = nil;
    // 用 ? 佔位,再由 sqlite3_bind 綁定,可避免 SQL 注入
    const char *sql = "insert into weiBo(screen_name, avatar_hd) values(?, ?)";
    if (sqlite3_prepare(db, sql, -1, &stmt, nil) == SQLITE_OK) {
        sqlite3_bind_text(stmt, 1, [dataModel.screen_name UTF8String], -1, NULL);
        sqlite3_bind_text(stmt, 2, [dataModel.avatar_hd UTF8String], -1, NULL);
        if (sqlite3_step(stmt) == SQLITE_DONE) {
            flag = YES;
        }
    }
    return flag;
}

#pragma mark - 刪
+ (BOOL)deleteModel:(DataModel *)dataModel {
    BOOL flag = NO;
    [self openDB];
    NSString *sql = [NSString stringWithFormat:@"delete from weiBo where screen_name = '%@'",
                     dataModel.screen_name];
    if (sqlite3_exec(db, sql.UTF8String, NULL, NULL, nil) == SQLITE_OK) {
        NSLog(@"刪除成功");
        flag = YES;
    }
    return flag;
}
@end

實務上有幾點值得注意:每次操作前開啟、操作後關閉雖然直覺,但頻繁開關會拖慢效能,正式專案建議改用 FMDB 這類封裝良好的第三方庫,並在應用進入背景時關閉連線以符合 iOS 的資料保護規範。字串拼接 SQL 也有注入風險,能改用參數綁定就盡量用參數綁定。

用 Firefox 的 SQLite Manager 建立資料庫

建立資料庫不需要寫程式,Firefox 的 SQLite Manager 外掛就綽綽有餘。

開啟瀏覽器,從「工具」中找到 SQLite Manager。

點「建立新的資料庫」。

建立完成後把檔案拖進 Xcode 專案,記得勾選 Copy items if needed。

接著建立資料表,並逐一新增欄位(欄位可以理解為模型的屬性)。

資料表建立完成後的樣子:

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