plist 屬性列表、Preference 偏好設定、NSKeyedArchiver 归档(NSCoding)、SQLite3、Core Data。
每個 iOS App 都有屬於自己的沙盒,也就是一個獨立目錄,與其他 App 完全隔離。App 只能在自己的沙盒內活動,無法存取別人的資料。
假設 App 名稱為 Layer,其沙盒目錄結構大致如下:
Documents:存放重要資料與使用者可見的檔案,iTunes 備份時會一併保存。
tmp:暫存檔,系統在 App 未執行時可能隨時清除。
Library/Caches:快取資料,不會被 iTunes 備份,系統在儲存空間不足時可能刪除。
Library/Preference:偏好設定,透過 NSUserDefaults 存取。
不建議直接拼接 Documents 字串,因為新版本系統可能調整目錄名稱。正確做法是用 NSHomeDirectory() 搭配 NSSearchPathForDirectoriesInDomains:
// 取得 Documents 目錄 NSString *home = NSHomeDirectory(); NSString *documents = [home stringByAppendingPathComponent:@"Documents"]; // 建議寫法 // NSUserDomainMask 代表從使用者目錄下尋找,YES 代表展開路徑中的 ~ 字元 NSArray *array = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES); // 在 iOS 中只有一個目錄會符合條件,因此集合裡只有一個元素 NSString *documents = [array objectAtIndex:0];
tmp:NSString *tmp = NSTemporaryDirectory();
Library/Caches:用沙盒根目錄拼接 "Caches",或把 NSSearchPathForDirectoriesInDomains 的第二個參數改成 NSCachesDirectory。
Library/Preference:透過 NSUserDefaults 類存取其中的設定資訊。
屬性列表是一種 XML 格式的檔案,副檔名為 plist。若物件是 NSString、NSDictionary、NSArray、NSData、NSNumber 等型別,可以直接用 writeToFile:atomically: 寫入。
// 將資料封裝成字典 NSMutableDictionary *dict = [NSMutableDictionary dictionary]; [dict setObject:@"母雞" forKey:@"name"]; [dict setObject:@"15013141314" forKey:@"phone"]; [dict setObject:@"27" forKey:@"age"]; // 將字典持久化到 Documents/stu.plist [dict writeToFile:path atomically:YES];
NSDictionary *dict = [NSDictionary dictionaryWithContentsOfFile:path]; NSLog(@"name:%@", [dict objectForKey:@"name"]); NSLog(@"phone:%@", [dict objectForKey:@"phone"]); NSLog(@"age:%@", [dict objectForKey:@"age"]);
很多 App 需要儲存使用者名稱、密碼、字型大小等設定,iOS 提供了標準方案。每個 App 都有一個 NSUserDefaults 單例用來存取偏好設定。
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults]; [defaults setObject:@"itcast" forKey:@"username"]; [defaults setFloat:18.0f forKey:@"text_size"]; [defaults setBool:YES forKey:@"auto_login"];
NSUserDefaults *defaults = [NSUserDefaults standardUserDefaults]; NSString *username = [defaults stringForKey:@"username"]; float textSize = [defaults floatForKey:@"text_size"]; BOOL autoLogin = [defaults boolForKey:@"auto_login"];
注意:NSUserDefaults 寫入資料時並非立即落地,而是依時間戳週期性地把記憶體中的快取寫入磁碟。因此呼叫完 set 方法後,資料有可能還沒寫入就結束程式。若需要確保立即寫入,請呼叫 [defaults synchronize];(新版的系統已大幅改善這個問題,但仍建議保留)。
若物件是 NSString、NSDictionary、NSArray、NSData、NSNumber 等型別,可以直接用 NSKeyedArchiver 归档與還原。自訂類別則必須先遵守 NSCoding 協議。
NSCoding 有兩個方法:
encodeWithCoder: 每次归档物件時呼叫,在裡面指定如何归档每個實例變數,用 encodeObject:forKey: 處理。
initWithCoder: 每次從檔案還原物件時呼叫,在裡面指定如何解碼,用 decodeObjectForKey: 處理。
@interface Person : NSObject <NSCoding> @property (nonatomic, copy) NSString *name; @property (nonatomic, assign) int age; @property (nonatomic, assign) float height; @end
@implementation Person
- (void)encodeWithCoder:(NSCoder *)encoder {
[encoder encodeObject:self.name forKey:@"name"];
[encoder encodeInt:self.age forKey:@"age"];
[encoder encodeFloat:self.height forKey:@"height"];
}
- (id)initWithCoder:(NSCoder *)decoder {
self.name = [decoder decodeObjectForKey:@"name"];
self.age = [decoder decodeIntForKey:@"age"];
self.height = [decoder decodeFloatForKey:@"height"];
return self;
}
@end
// 归档(編碼) Person *person = [[Person alloc] init]; person.name = @"MJ"; person.age = 27; person.height = 1.83f; [NSKeyedArchiver archiveRootObject:person toFile:path]; // 還原(解碼) Person *person = [NSKeyedUnarchiver unarchiveObjectWithFile:path];
若父類別也遵守了 NSCoding 協議,請務必:
在 encodeWithCoder: 中加上 [super encodeWithCoder:encoder];,確保繼承而來的實例變數也被編碼。
在 initWithCoder: 中加上 self = [super initWithCoder:decoder];,確保繼承而來的實例變數也能被解碼。
archiveRootObject:toFile: 一次只能寫一個物件。若要把多個物件存進同一個檔案,就要用 NSData 作為暫存空間。
// 建立一塊可變資料區 NSMutableData *data = [NSMutableData data]; // 把資料區接到 NSKeyedArchiver NSKeyedArchiver *archiver = [[NSKeyedArchiver alloc] initForWritingWithMutableData:data]; [archiver encodeObject:person1 forKey:@"person1"]; [archiver encodeObject:person2 forKey:@"person2"]; [archiver finishEncoding]; // 一定要呼叫 [data writeToFile:path atomically:YES];
NSData *data = [NSData dataWithContentsOfFile:path]; NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:data]; Person *person1 = [unarchiver decodeObjectForKey:@"person1"]; Person *person2 = [unarchiver decodeObjectForKey:@"person2"]; [unarchiver finishDecoding];
// 把 person1 的資料暫存下來 NSData *data = [NSKeyedArchiver archivedDataWithRootObject:person1]; // 解析 data,得到一個全新的物件 Person *person2 = [NSKeyedUnarchiver unarchiveObjectWithData:data]; NSLog(@"person1:%p", person1); // person1:0x7177a60 NSLog(@"person2:%p", person2); // person2:0x7177cf0
兩者記憶體位址不同,代表是完全獨立的兩個物件,這正是深拷貝的效果。
SQLite3 是一套開源的嵌入式關聯式資料庫,可攜性佳、易使用、記憶體開銷小。它是「無型別」的,也就是說你可以把任何型別的資料存進任意表、任意欄位。以下建表語句是合法的:
create table t_person(name, age);
但為了可讀性,建議還是把欄位型別標上:
create table t_person(name text, age integer);
常用的五種資料型別:text、integer、float、boolean、blob。
在 iOS 中使用 SQLite3,第一步是加入 libsqlite3.dylib(新版為 libsqlite3.tbd)並導入 <sqlite3.h>。
sqlite3 *db; int result = sqlite3_open([path UTF8String], &db);
sqlite3_open() 會依路徑開啟資料庫,若檔案不存在則建立新的。result 等於 SQLITE_OK 代表成功。注意路徑必須以 C 字串傳入,而不是 NSString。
sqlite3_close(db);
char *errorMsg = NULL; char *sql = "create table if not exists t_person(id integer primary key autoincrement, name text, age integer);"; int result = sqlite3_exec(db, sql, NULL, NULL, &errorMsg);
sqlite3_exec() 可執行任何 SQL,如建表、更新、插入、刪除,但不適合查詢,因為它不會把查到的資料交回來。它也能執行 begin transaction;、rollback;、commit; 等事務語句。
char *sql = "insert into t_person(name, age) values(?, ?);";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
sqlite3_bind_text(stmt, 1, "母雞", -1, NULL);
sqlite3_bind_int(stmt, 2, 27);
}
if (sqlite3_step(stmt) != SQLITE_DONE) {
NSLog(@"插入資料錯誤");
}
sqlite3_finalize(stmt);
參數說明:
sqlite3_prepare_v2() 傳回 SQLITE_OK 表示語句已準備成功、沒有語法問題。
sqlite3_bind_text() 等綁定函式的參數:第一個是 statement,第二個是佔位符位置(從 1 開始,不是 0),第三個是要綁定的值,第四個是資料長度(C 字串可傳 -1),第五個是可選的回呼,通常用於語句執行後的記憶體清理。
sqlite3_step() 執行語句,傳回 SQLITE_DONE 代表成功。
sqlite3_finalize() 銷毀 statement 物件。
char *sql = "select id, name, age from t_person;";
sqlite3_stmt *stmt;
if (sqlite3_prepare_v2(db, sql, -1, &stmt, NULL) == SQLITE_OK) {
while (sqlite3_step(stmt) == SQLITE_ROW) {
int _id = sqlite3_column_int(stmt, 0);
char *_name = (char *)sqlite3_column_text(stmt, 1);
NSString *name = [NSString stringWithUTF8String:_name];
int _age = sqlite3_column_int(stmt, 2);
NSLog(@"id=%i, name=%@, age=%i", _id, name, _age);
}
}
sqlite3_finalize(stmt);
sqlite3_step() 傳回 SQLITE_ROW 代表讀到一筆新紀錄;sqlite3_column_*() 用來取出各欄位的值,第二個參數是欄位索引,從 0 開始。
Core Data 不是資料庫,而是一套物件圖管理框架,底層預設使用 SQLite 作為持久化存儲。
透過 Core Data 取出的物件預設都是 NSManagedObject。它的操作方式有點像 NSDictionary,用「鍵—值」對來存取所有實體屬性:
setValue:forKey: 設定屬性值(屬性名為 key)。
valueForKey: 取得屬性值(屬性名為 key)。
NSManagedObjectModel 是模型;NSPersistentStoreCoordinator 是持久化存儲協調者;NSManagedObjectContext 是操作上下文;NSPersistentStore 是實際的存儲庫。
// 1. 從 App bundle 載入模型檔
NSManagedObjectModel *model = [NSManagedObjectModel mergedModelFromBundles:nil];
// 2. 傳入模型,初始化持久化存儲協調者
NSPersistentStoreCoordinator *psc =
[[NSPersistentStoreCoordinator alloc] initWithManagedObjectModel:model];
// 3. 建立 SQLite 檔案路徑
NSString *docs = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) lastObject];
NSURL *url = [NSURL fileURLWithPath:[docs stringByAppendingPathComponent:@"person.data"]];
// 4. 加入持久化存儲庫
NSError *error = nil;
NSPersistentStore *store = [psc addPersistentStoreWithType:NSSQLiteStoreType
configuration:nil
URL:url
options:nil
error:&error];
if (store == nil) {
[NSException raise:@"添加資料庫錯誤" format:@"%@", [error localizedDescription]];
}
// 5. 建立上下文並指定 coordinator
NSManagedObjectContext *context = [[NSManagedObjectContext alloc] init];
context.persistentStoreCoordinator = psc;
// 建立 Person 實體
NSManagedObject *person = [NSEntityDescription insertNewObjectForEntityForName:@"Person"
inManagedObjectContext:context];
[person setValue:@"MJ" forKey:@"name"];
[person setValue:[NSNumber numberWithInt:27] forKey:@"age"];
// 建立 Card 實體
NSManagedObject *card = [NSEntityDescription insertNewObjectForEntityForName:@"Card"
inManagedObjectContext:context];
[card setValue:@"4414241933432" forKey:@"no"];
// 建立關聯
[person setValue:card forKey:@"card"];
// 同步到持久化存儲庫
NSError *error = nil;
BOOL success = [context save:&error];
if (!success) {
[NSException raise:@"訪問資料庫錯誤" format:@"%@", [error localizedDescription]];
}
更新操作同理:改完實體屬性後呼叫一次 [context save:&error] 即可。
NSFetchRequest *request = [[NSFetchRequest alloc] init];
// 指定要查詢的實體
NSEntityDescription *desc = [NSEntityDescription entityForName:@"Person"
inManagedObjectContext:context];
request.entity = desc;
// 排序(依 age 遞減)
NSSortDescriptor *sort = [NSSortDescriptor sortDescriptorWithKey:@"age" ascending:NO];
request.sortDescriptors = [NSArray arrayWithObject:sort];
// 條件過濾
NSPredicate *predicate = [NSPredicate predicateWithFormat:@"name like %@", @"*Itcast-1*"];
request.predicate = predicate;
// 執行
NSError *error = nil;
NSArray *objs = [context executeFetchRequest:request error:&error];
if (error) {
[NSException raise:@"查詢錯誤" format:@"%@", [error localizedDescription]];
}
for (NSManagedObject *obj in objs) {
NSLog(@"name=%@", [obj valueForKey:@"name"]);
}
[context deleteObject:managedObject];
NSError *error = nil;
[context save:&error];
if (error) {
[NSException raise:@"刪除錯誤" format:@"%@", [error localizedDescription]];
}
在 App 啟動參數或 scheme 的 launch arguments 中加入 -com.apple.CoreData.SQLDebug 1,即可在 console 看到 Core Data 實際送出的 SQL 語句,對排查效能問題非常有幫助。
Core Data 不會依關聯關係立即抓取相關物件。例如取出 Person 實體時,並不會馬上去查關聯的 Card;直到應用真的存取 Card,才會向資料庫發查詢並載入。這就是所謂的 fault(缺省)機制,能有效降低初始載入成本,但也意味著若在物件離開上下文後才存取關聯,可能導致 crash。
預設取出的實體都是 NSManagedObject,能用鍵—值對存取資料。但若需要在存取資料之外加上業務方法,就必須自訂子類。在 Xcode 中選中實體,於 Data Model Inspector 把 Class 欄位改成自訂類別名稱,再選 Editor → Create NSManagedObject Subclass 即可產生程式碼。
少量、結構簡單的設定資料用 NSUserDefaults 或 plist 就夠了;需要應付自訂類別的複雜物件圖,用 NSKeyedArchiver 归档;資料量大、需要複雜查詢與關聯,選 SQLite3 或 Core Data。Core Data 開發效率高、能自動處理物件圖與版本遷移,但抽象層較厚;SQLite3 直接可控、效能可預期,卻要自己寫所有 SQL 與表格對應。團隊若已有 SQL 經驗,兩者搭配使用也是常見做法。