資料儲存是每個應用都繞不開的課題。若 App 與後端配合,多數資料存在伺服器;但設定、快取、使用者自訂的複合物件,仍需要落地到本地。
前一篇談了 plist 儲存,但它只適合簡單的鍵值對。若要把自訂類別(例如含圖片的 Book)存進 plist,就需要 NSCoding 協議——把物件序列化為位元組流再存檔,讀取時反序列化回物件。這裡的核心角色就是 NSCoder。
若對「存檔/解壓」沒概念,可以直接理解為序列化與反序列化。
NSCoding 是一個協議。遵循它就必須實作兩個方法:
- (void)encodeWithCoder:(NSCoder *)aCoder; - (id)initWithCoder:(NSCoder *)aDecoder;
兩者的參數都是 NSCoder——archive 位元組流的抽象類別。你可以把資料寫入 coder,也可以從 coder 讀回。
NSCoder 是抽象類別,不能直接實例化。實務上透過它的兩個子類:
· NSKeyedArchiver —— 把物件寫入位元組流/檔案
· NSKeyedUnarchiver —— 從位元組流/檔案讀出物件
// Book.h #import <Foundation/Foundation.h> #import <UIKit/UIKit.h> @interface Book : NSObject <NSCoding> @property (strong, nonatomic) UIImage *ConverPicture; @property (strong, nonatomic) NSString *BookName; @property (strong, nonatomic) NSString *Author; @property (strong, nonatomic) NSNumber *Price; @end
// Book.m
@implementation Book
- (void)encodeWithCoder:(NSCoder *)aCoder {
// UIImage 的處理與其他型別不同:需先轉為 NSData
[aCoder encodeObject:UIImageJPEGRepresentation(self.ConverPicture, 1.0)
forKey:@"ConverPicture"];
[aCoder encodeObject:_BookName forKey:@"BookName"];
[aCoder encodeObject:_Author forKey:@"Author"];
[aCoder encodeObject:_Price forKey:@"Price"];
}
- (id)initWithCoder:(NSCoder *)aDecoder {
self.ConverPicture = [UIImage imageWithData:[aDecoder decodeObjectForKey:@"ConverPicture"]];
self.BookName = [aDecoder decodeObjectForKey:@"BookName"];
self.Author = [aDecoder decodeObjectForKey:@"Author"];
self.Price = [aDecoder decodeObjectForKey:@"Price"];
return self;
}
@end
這裡有個容易出錯的地方:UIImage 本身不遵循 NSCoding(在早期 SDK 中),所以必須先用 UIImageJPEGRepresentation 或 UIImagePNGRepresentation 轉成 NSData 再存,讀回時用 imageWithData: 還原。
另外請注意 initWithCoder: 的正確寫法應該呼叫 [super init] 並回傳 self,而不是像範例這樣直接把值指派到 ivar 就 return。標準寫法:
- (instancetype)initWithCoder:(NSCoder *)aDecoder {
self = [super init];
if (self) {
_ConverPicture = [UIImage imageWithData:[aDecoder decodeObjectForKey:@"ConverPicture"]];
_BookName = [aDecoder decodeObjectForKey:@"BookName"];
_Author = [aDecoder decodeObjectForKey:@"Author"];
_Price = [aDecoder decodeObjectForKey:@"Price"];
}
return self;
}
ViewController 中定義三個屬性:
@property (strong, nonatomic) NSString *storagePath; // 單檔路徑 @property (strong, nonatomic) NSString *storageListPath; // 多檔路徑 @property (strong, nonatomic) NSMutableArray *bookList;
設定路徑(前兩個存單筆,後面存多筆):
NSArray *codepath = NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES); _storagePath = [codepath[0] stringByAppendingPathComponent:@"book.plist"]; _storageListPath = [codepath[0] stringByAppendingPathComponent:@"booklist.plist"]; NSLog(@"%@", NSHomeDirectory());
Book *book = [[Book alloc] init];
UIImage *image = [UIImage imageNamed:@"Code1.jpg"];
book.ConverPicture = image;
book.BookName = @"百年孤獨";
book.Author = @"加西亞.馬爾克斯";
book.Price = [[NSNumber alloc] initWithInteger:45];
if ([NSKeyedArchiver archiveRootObject:book toFile:_storagePath]) {
NSLog(@"數據存檔成功");
}
Book *decodeBook = [NSKeyedUnarchiver unarchiveObjectWithFile:_storagePath]; self.myImageView.image = decodeBook.ConverPicture; NSLog(@"%@", decodeBook.ConverPicture); NSLog(@"%@", decodeBook.BookName); NSLog(@"解檔成功");
self.bookList = [NSMutableArray array];
for (NSInteger i = 1; i < 3; i++) {
Book *book = [[Book alloc] init];
NSString *imageName = [NSString stringWithFormat:@"Code%ld.jpg", (long)i];
book.ConverPicture = [UIImage imageNamed:imageName];
book.BookName = [NSString stringWithFormat:@"百年孤獨%ld", (long)i];
book.Author = [NSString stringWithFormat:@"加西亞.馬爾克斯%ld", (long)i];
book.Price = [[NSNumber alloc] initWithInteger:45];
[self.bookList addObject:book];
}
if ([NSKeyedArchiver archiveRootObject:self.bookList toFile:_storageListPath]) {
NSLog(@"數據存檔成功");
}
self.bookList = [NSKeyedUnarchiver unarchiveObjectWithFile:_storageListPath]; Book *nextBook = self.bookList[1]; self.myImageView.image = nextBook.ConverPicture; NSLog(@"解檔成功");
archiveRootObject 是**全量**操作:存檔時序列化整個物件圖,解檔時還原整個物件圖。
這意味著:想修改 100 筆資料中的第 37 筆,你必須先把 100 筆全部解檔、修改、再把 100 筆全部存檔。資料量小時很方便,資料量一大就是效能災難——而且這個過程是同步的,會直接卡住主線程。
· NSUserDefaults —— 少量設定、旗標、小型 plist 型別資料。
· NSCoding / NSKeyedArchiver —— 自訂複合物件、需要保留物件圖結構的場景;資料量小且變動不頻繁。
· plist 直接读写 —— 純 NSString/NSNumber/NSArray/NSDictionary 的結構化資料。
· Core Data/SQLite/Realm —— 資料量大、需要查詢、需要局部更新的正式場景。這才是唯一正確的選擇。
1. archiveRootObject:toFile: 已於 iOS 12 廢棄。請改用 NSKeyedArchiver 的 archivedDataWithRootObject:requiringSecureCoding:error: 並自行寫檔:
NSError *error = nil;
NSData *data = [NSKeyedArchiver archivedDataWithRootObject:book
requiringSecureCoding:NO
error:&error];
if (data) {
[data writeToFile:_storagePath atomically:YES];
}
讀取對應使用 unarchivedObjectOfClass:fromData:error:。這個新 API 的好處是會明確型別檢查,避免惡意建構的 archive 造成意料外的物件。
2. 若資料含敏感資訊,請考慮 NSSecureCoding。它要求解檔端明確指定可接受的類別白名單,能有效阻擋 archive 替換攻擊。遵循 NSSecureCoding 時還需實作 +supportsSecureCoding 並改用 decodeObjectOfClass:forKey:。
3. 大量圖片請勿存進 archive。圖片以 NSData 形式內嵌會讓檔案迅速膨脹。正確做法是圖片存到 Caches 或 Files 目錄、archive 中只存檔名或路徑。
4. 存檔請一律加 atomically:YES。否則寫入途中若 App 被終止,檔案會變成半截的損毀狀態。