在實際開發中,熟練運用 SQLite 對 App 內數據進行操作,是移動開發人員至關重要的技能。iOS 封裝的 Core Data 固然是對 SQLite 的二層封裝,FMDB 也能幫程序員省去不少麻煩、提升效率;但既然是封裝,性能自然不如直接操作 SQL 語句。本文將示範如何打造一個原生 SQLite 數據庫管理類。
設置類方法創建單例對象——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;
}
#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(@"對應數據修改成功");
}
}
- (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