資料持久化,實際上就是把資料保存到本地硬碟。iOS 應用程式的本地硬碟稱為「沙盒」,其實就是一個資料夾,其下主要有四個目錄:
· Documents:儲存使用者長期使用的檔案。
· Library:其中又分 Caches(暫存檔案、快取)與 Preferences(偏好設定,例如是否為首次啟動)。
· tmp:暫存檔案,與 Caches 略有差異。
· App 包:編譯後的檔案,不可修改。
要對某類別的物件進行歸檔,該類別必須遵循 NSCoding 協定。
// Person.h
#import <Foundation/Foundation.h>
@interface Person : NSObject <NSCoding>
@property (nonatomic, copy) NSString *name;
@property (nonatomic, copy) NSString *gender;
@property (nonatomic, assign) NSInteger age;
- (id)initWithName:(NSString *)name gender:(NSString *)gender age:(NSInteger)age;
@end
// Person.m
#import "Person.h"
@implementation Person
- (id)initWithName:(NSString *)name gender:(NSString *)gender age:(NSInteger)age {
self = [super init];
if (self) {
self.name = name;
self.gender = gender;
self.age = age;
}
return self;
}
// 歸檔時呼叫,為各實例變數進行編碼
- (void)encodeWithCoder:(NSCoder *)aCoder {
[aCoder encodeObject:_name forKey:@"name"];
[aCoder encodeObject:_gender forKey:@"gender"];
[aCoder encodeObject:@(_age) forKey:@"age"];
}
// 反歸檔時呼叫,為各實例變數進行解碼
- (id)initWithCoder:(NSCoder *)aDecoder {
self = [super init];
if (self) {
self.name = [aDecoder decodeObjectForKey:@"name"];
self.gender = [aDecoder decodeObjectForKey:@"gender"];
self.age = [[aDecoder decodeObjectForKey:@"age"] integerValue];
}
return self;
}
@end
// 歸檔
- (void)pigeonholeClick:(UIButton *)pigeonholeBtn {
UITextField *tf1 = (UITextField *)[self.view viewWithTag:100];
UITextField *tf2 = (UITextField *)[self.view viewWithTag:101];
// 封裝成 Person 物件
Person *per = [[Person alloc] initWithName:tf1.text gender:tf2.text age:18];
// 1. 建立歸檔物件
NSMutableData *data = [NSMutableData data];
NSKeyedArchiver *archiver = [[NSKeyedArchiver alloc] initForWritingWithMutableData:data];
// 2. 歸檔
[archiver encodeObject:per forKey:@"Tsummer"];
// 3. 結束歸檔(結束後再歸檔無效)
[archiver finishEncoding];
// 4. 將 data 寫入檔案
[data writeToFile:[self getFilePath] atomically:YES];
}
// 反歸檔
- (void)againstPigeonholeClick:(UIButton *)againstPigeonholeBtn {
// 1. 依檔案路徑初始化資料物件
NSMutableData *mData = [NSMutableData dataWithContentsOfFile:[self getFilePath]];
// 2. 建立反歸檔物件
NSKeyedUnarchiver *unarchiver = [[NSKeyedUnarchiver alloc] initForReadingWithData:mData];
// 3. 反歸檔
Person *per = [unarchiver decodeObjectForKey:@"Tsummer"];
// 4. 結束反歸檔
[unarchiver finishDecoding];
}
// 取得檔案路徑
- (NSString *)getFilePath {
// 1. 取得 Documents 目錄路徑
NSString *documentsPath = [NSSearchPathForDirectoriesInDomains(NSDocumentDirectory, NSUserDomainMask, YES) firstObject];
// 2. 拼接檔案名稱
NSString *newFilePath = [documentsPath stringByAppendingPathComponent:@"Tsummer.txt"];
return newFilePath;
}
重點:歸檔透過 NSKeyedArchiver 將物件編碼成 NSData 後寫入檔案;反歸檔則透過 NSKeyedUnarchiver 從檔案讀回資料並還原物件。前提是自訂類別必須實作 encodeWithCoder: 與 initWithCoder: 兩個方法。