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

iOS 開發:用 NSCoding 與 NSCoder 做資料持久化

編輯:iOS 開發綜合

資料儲存是每個應用都繞不開的課題。若 App 與後端配合,多數資料存在伺服器;但設定、快取、使用者自訂的複合物件,仍需要落地到本地。

前一篇談了 plist 儲存,但它只適合簡單的鍵值對。若要把自訂類別(例如含圖片的 Book)存進 plist,就需要 NSCoding 協議——把物件序列化為位元組流再存檔,讀取時反序列化回物件。這裡的核心角色就是 NSCoder。

若對「存檔/解壓」沒概念,可以直接理解為序列化與反序列化。

一、基礎概念

NSCoding 是一個協議。遵循它就必須實作兩個方法:

- (void)encodeWithCoder:(NSCoder *)aCoder;
- (id)initWithCoder:(NSCoder *)aDecoder;

兩者的參數都是 NSCoder——archive 位元組流的抽象類別。你可以把資料寫入 coder,也可以從 coder 讀回。

NSCoder 是抽象類別,不能直接實例化。實務上透過它的兩個子類:

· NSKeyedArchiver —— 把物件寫入位元組流/檔案
· NSKeyedUnarchiver —— 從位元組流/檔案讀出物件

二、建立 Book 類別

// 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;
}

三、Demo 實作

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 被終止,檔案會變成半截的損毀狀態。

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