SQLite 是一款輕量級的嵌入式資料庫,Android 與 iOS 平台採用的是同一套引擎。它的資源佔用極低,在嵌入式環境下往往只要幾百 KB 記憶體就足夠;處理速度相對於 MySQL、PostgreSQL 這類大型關聯式資料庫也毫不遜色。由於以 C 語言實作,跨平台能力很強,幾乎所有主流系統都能見到它的身影。
要在 iOS 中使用 SQLite3,需要在 Xcode 專案的 Link Binary With Libraries 中加入 libsqlite3:
建立資料表: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 條件運算式;
int sqlite3_open(const char *filename, /* 資料庫路徑(UTF-8) */
sqlite3 **pDb); /* 回傳的資料庫 handle */
int sqlite3_prepare_v2(sqlite3 *db, /* 資料庫 handle */
const char *zSql, /* SQL 語句(UTF-8) */
int nByte, /* SQL 最大長度,-1 代表自動 */
sqlite3_stmt **ppStmt,/* 回傳的 statement */
const char **pzTail); /* 回傳未解析的殘餘字串 */
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);
以下以微博介面回傳的資料為例,先定義一個資料模型。
#import <Foundation/Foundation.h>
@interface DataModel : NSObject
@property (nonatomic, copy) NSString *screen_name;
@property (nonatomic, copy) NSString *avatar_hd;
- (instancetype)initWithDictionary:(NSDictionary *)dictionary;
@end
#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
#import <Foundation/Foundation.h>
#import "DataModel.h"
@interface DataBase : NSObject
+ (void)openDB; // 開啟
+ (NSArray *)find; // 查
+ (BOOL)insertModel:(DataModel *)dataModel; // 增
+ (BOOL)deleteModel:(DataModel *)dataModel; // 刪
@end
#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 外掛就綽綽有餘。
開啟瀏覽器,從「工具」中找到 SQLite Manager。
點「建立新的資料庫」。
建立完成後把檔案拖進 Xcode 專案,記得勾選 Copy items if needed。
接著建立資料表,並逐一新增欄位(欄位可以理解為模型的屬性)。
資料表建立完成後的樣子: