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

iOS 归档學習筆記:plist 與 NSKeyedArchiver 兩種路徑

編輯:iOS 開發綜合

所謂「归档」,是指用某種格式把一個或多個物件保存下來,以便日後還原成原本狀態的過程。iOS 提供了兩條主要路徑。

一、用 XML 屬性列表归档

如果物件是 NSString、NSDictionary、NSArray、NSData、NSNumber 這幾種類型,可以直接呼叫類別中已有的 writeToFile:atomically: 把資料寫入檔案。

讀回時分別對應使用:

[NSDictionary dictionaryWithContentsOfFile:]

[NSArray arrayWithContentsOfFile:]

[NSData dataWithContentsOfFile:]

[NSString stringWithContentsOfFile:]

atomically: 參數建議固定傳 YES。它代表「先寫入暫存檔,全部成功後再一口氣取代目標檔案」,如此一來即使寫到一半被系統終止,原本的檔案也不會被破壞成一半的狀態。

二、用 NSKeyedArchiver 归档

如果要把各種型別的物件存進檔案,而不只是字串、陣列和字典,就需要更靈活的做法:用 NSKeyedArchiver 建立「帶鍵的檔案」。

所謂帶鍵,是指每一個被归档的欄位都有一個名稱(鍵)。归档時為資料取一個鍵,讀取時再用同一個鍵把它取回來。這樣做的好處是欄位的順序、數量都可以變動而不影響相容性,這也是它比 archivedDataWithRootObject: 更受推薦的原因。

三、自訂類別必須實作 NSCoding

自訂的類別物件無法直接归档,因為系統不知道你的物件該怎麼拆解與重組。做法是讓類別遵守 <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 這類真正的儲存方案。

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