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

iOS SQLite 實戰(Objective-C):從零打造數據庫管理類

編輯:iOS 開發綜合

在實際開發中,熟練運用 SQLite 對 App 內數據進行操作,是移動開發人員至關重要的技能。iOS 封裝的 Core Data 固然是對 SQLite 的二層封裝,FMDB 也能幫程序員省去不少麻煩、提升效率;但既然是封裝,性能自然不如直接操作 SQL 語句。本文將示範如何打造一個原生 SQLite 數據庫管理類。

創建數據庫管理類 SQLiteManager

設置類方法創建單例對象——OC 中既可單獨用類方法創建單例,也可用原始 init 方法創建普通對象。

// .h
@interface SQLiteManager : NSObject
// 類方法生成單例對象
+ (instancetype)shareInstance;
@end

// .m
@implementation SQLiteManager
static SQLiteManager *instance;
+ (instancetype)shareInstance {
    static dispatch_once_t onceToken;
    dispatch_once(&onceToken, ^{
        instance = [[self alloc] init];
    });
    return instance;
}
@end

操作數據庫

首先需要在項目中導入 libsqlite3.tbd 框架。

然後在 SQLiteManager 中引入頭文件:

#import <sqlite3.h>

打開數據庫

在 .h 文件中暴露打開數據庫的接口:

// 打開數據庫
- (BOOL)openDB;

.m 文件中即可實現各項數據庫操作方法。SQL 語句建議直接複製粘貼,以免拼寫出錯(這大概是本文最實用的一句話了)。

#pragma mark - 打開/創建數據庫
- (BOOL)openDB {
    // app 內數據庫文件存放路徑,一般放在沙盒中
    NSString *documentPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
    NSString *DBPath = [documentPath stringByAppendingPathComponent:@"appDB.sqlite"];
    // 創建(指定路徑不存在)/打開(已存在)數據庫文件
    // sqlite3_open(filename, ppDb) filename: 數據庫路徑 ppDb: 數據庫對象
    if (sqlite3_open(DBPath.UTF8String, &_db) != SQLITE_OK) {
        // 數據庫打開失敗
        return NO;
    } else {
        // 打開成功,創建表
        return [self creatTable];
    }
}
- (BOOL)creatTable {
    // 用戶表
    NSString *creatUserTable = @"CREATE TABLE IF NOT EXISTS 't_User' ( 'ID' INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,'name' TEXT,'age' INTEGER,'icon' TEXT);";
    // 車表
    NSString *creatCarTable = @"CREATE TABLE IF NOT EXISTS 't_Car' ( 'ID' INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,'type' TEXT,'output' REAL,'master' TEXT)";
    // 項目中一般不會只有一個表
    NSArray *SQL_ARR = [NSArray arrayWithObjects:creatUserTable, creatCarTable, nil];
    return [self creatTableExecSQL:SQL_ARR];
}
- (BOOL)creatTableExecSQL:(NSArray *)SQL_ARR {
    for (NSString *SQL in SQL_ARR) {
        if (![self execSQL:SQL]) {
            return NO;
        }
    }
    return YES;
}
#pragma mark 執行 SQL 語句
- (BOOL)execSQL:(NSString *)SQL {
    return sqlite3_exec(self.db, SQL.UTF8String, nil, nil, nil) == SQLITE_OK;
}

數據庫內 SQL 操作

#pragma mark 執行 SQL 語句
- (BOOL)execSQL:(NSString *)SQL {
    return sqlite3_exec(self.db, SQL.UTF8String, nil, nil, nil) == SQLITE_OK;
}

若需要更新數據庫對應表中的數據,直接調用 SQL 執行方法即可:

- (void)updateIcon {
    // 更新對應的 SQL 語句
    NSString *SQL = [NSString stringWithFormat:@"UPDATE 't_User' SET icon='%@' WHERE name = '%@'", @"https://qiuxuewei.com/newIcon.png", @"name_6"];
    if ([[SQLiteManager shareInstance] execSQL:SQL]) {
        NSLog(@"對應數據修改成功");
    }
}

項目中的自定義 Model 對象,可定義一個將自身插入數據庫的方法

- (BOOL)insertSelfToDB {
    // 插入對象的 SQL 語句
    NSString *insertSQL = [NSString stringWithFormat:@"INSERT INTO 't_User' (name,age,icon) VALUES ('%@',%ld,'%@');", self.name, self.age, self.icon];
    return [[SQLiteManager shareInstance] execSQL:insertSQL];
}

查詢數據庫中對應表的所有數據

#pragma mark - 查詢數據庫中數據
- (NSArray *)querySQL:(NSString *)SQL {
    // 準備查詢
    // 參數一: 數據庫對象
    // 參數二: 查詢語句
    // 參數三: 查詢語句長度 -1
    // 參數四: 句柄(游標對象)
    // sqlite3_prepare_v2(db, zSql, nByte, ppStmt, pzTail)
    sqlite3_stmt *stmt = nil;
    if (sqlite3_prepare_v2(self.db, SQL.UTF8String, -1, &stmt, nil) != SQLITE_OK) {
        NSLog(@"準備查詢失敗!");
        return NULL;
    }
    // 準備成功,開始查詢數據
    // 定義一個存放數據字典的可變數組
    NSMutableArray *dictArrM = [[NSMutableArray alloc] init];
    while (sqlite3_step(stmt) == SQLITE_ROW) {
        // 獲取表中所有列數(字段數)
        int columnCount = sqlite3_column_count(stmt);
        // 定義存放字段數據的字典
        NSMutableDictionary *dict = [[NSMutableDictionary alloc] init];
        for (int i = 0; i < columnCount; i++) {
            // 取出 i 位置列的字段名,作為字典的 key
            const char *cKey = sqlite3_column_name(stmt, i);
            NSString *key = [NSString stringWithUTF8String:cKey];
            // 取出 i 位置存儲的值,作為字典的 value
            const char *cValue = (const char *)sqlite3_column_text(stmt, i);
            NSString *value = [NSString stringWithUTF8String:cValue];
            [dict setObject:value forKey:key];
        }
        [dictArrM addObject:dict];
    }
    return dictArrM;
}

在自定義模型中定義一個工廠方法,可將表中所有數據以模型數組的形式輸出

+ (NSArray *)allUserFromDB {
    // 查詢表中所有數據的 SQL 語句
    NSString *SQL = @"SELECT name,age,icon FROM 't_User'";
    // 取出所有數據
    NSArray *allUserDictArr = [[SQLiteManager shareInstance] querySQL:SQL];
    NSLog(@"%@", allUserDictArr);
    // 將字典數組轉化為模型數組
    NSMutableArray *modelArrM = [[NSMutableArray alloc] init];
    for (NSDictionary *dict in allUserDictArr) {
        [modelArrM addObject:[[User alloc] initWithDict:dict]];
    }
    return modelArrM;
}

源碼已上傳 GitHub:https://github.com/qxuewei/Swift-test/tree/master/SQLite數據庫操作-0C

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