所謂「归档」,是指用某種格式把一個或多個物件保存下來,以便日後還原成原本狀態的過程。iOS 提供了兩條主要路徑。
如果物件是 NSString、NSDictionary、NSArray、NSData、NSNumber 這幾種類型,可以直接呼叫類別中已有的 writeToFile:atomically: 把資料寫入檔案。
讀回時分別對應使用:
[NSDictionary dictionaryWithContentsOfFile:]
[NSArray arrayWithContentsOfFile:]
[NSData dataWithContentsOfFile:]
[NSString stringWithContentsOfFile:]
atomically: 參數建議固定傳 YES。它代表「先寫入暫存檔,全部成功後再一口氣取代目標檔案」,如此一來即使寫到一半被系統終止,原本的檔案也不會被破壞成一半的狀態。
如果要把各種型別的物件存進檔案,而不只是字串、陣列和字典,就需要更靈活的做法:用 NSKeyedArchiver 建立「帶鍵的檔案」。
所謂帶鍵,是指每一個被归档的欄位都有一個名稱(鍵)。归档時為資料取一個鍵,讀取時再用同一個鍵把它取回來。這樣做的好處是欄位的順序、數量都可以變動而不影響相容性,這也是它比 archivedDataWithRootObject: 更受推薦的原因。
自訂的類別物件無法直接归档,因為系統不知道你的物件該怎麼拆解與重組。做法是讓類別遵守 <NSCoding> 協議,並實作兩個方法:
encodeWithCoder: 告知归档程式「如何归档」。
initWithCoder: 告知系統「如何解归档」。
Objective-C 物件型別用 encodeObject:forKey: 編碼、decodeObjectForKey: 解碼;基本 C 型別則改用專用的方法,配對如下:
encodeBool:forKey: / decodeBoolForKey:
encodeInt:forKey: / decodeIntForKey:
encodeInt32:forKey: / decodeInt32ForKey:
encodeInt64:forKey: / decodeInt64ForKey:
encodeFloat:forKey: / decodeFloatForKey:
encodeDouble:forKey: / decodeDoubleForKey:
- (void)encodeWithCoder:(NSCoder *)coder {
[coder encodeObject:@"tongxue" forKey:@"name"];
[coder encodeInt:13 forKey:@"age"];
}
- (id)initWithCoder:(NSCoder *)aDecoder {
self = [super init];
if (self) {
_name = [aDecoder decodeObjectForKey:@"name"];
_age = [aDecoder decodeIntForKey:@"age"];
}
return self;
}
上面範例有兩個地方值得補充:
第一,initWithCoder: 一定要呼叫 super。許多人會漏掉 self = [super init] 或 [super initWithCoder:],導致父類別的初始化沒跑到,實務上容易出現難以追蹤的問題。
第二,initWithCoder: 應該寫成便利建構子。Apple 的慣例是實作 - (instancetype)initWithCoder:(NSCoder *)aDecoder,並在 initWithCoder: 中回傳 self,而不是像範例那樣直接 return self 卻沒先呼叫 super。
鍵名稱要穩定。一旦 App 上線,key 就不能任意改名或刪除,否則舊使用者升級後會讀不到自己的資料。建議把鍵名集中定義成常數。
記得判斷型別。用 decodeObjectForKey: 取出的物件若型別與預期不符,後續使用時會 crash。加上 isKindOfClass: 檢查是低成本的高保障做法。
archiveRootObject:toFile: 已不建議使用。若要在多個物件間共享同一個檔案,或想保留完整的類別資訊,請改用 archivedDataWithRootObject:requiringSecureCoding:error: 搭配 unarchivedObjectOfClass:fromData:error:,並以 NSSecureCoding 取代舊的 NSCoding。Secure Coding 會在解碼時驗證型別,能有效阻擋惡意建構的归档檔造成的攻擊。
归档不是資料庫。它適合保存使用者的設定、暫存狀態、小型快取。若資料有查詢、排序、關聯或大量增刪改的需求,請改用 SQLite、Core Data 或 GRDB 這類真正的儲存方案。