開發過程中有時需要儲存一些輕量級的資料,此時 iOS 提供的幾種儲存方式中,最合適的莫過於物件歸檔(NSCoding)。但對物件進行歸檔、解檔時需實作 encodeWithCoder 與 initWithCoder 兩個方法:前者是編碼,後者是解碼。
encodeWithCoder 傳入一個 NSCoder 物件,實作時可呼叫 encodeObject、encodeFloat、encodeInt 等方法並透過指定鍵值編碼;需要時則呼叫 decodeObjectForKey、decodeFloatForKey 等解碼。
先實作 encodeWithCoder 與 initWithCoder:
#import "MyModel.h"
@implementation MyModel
#define kCUSTIDKey @"CUSTIDKey"
#define kCUSTSTATUSKey @"CUSTSTATUSKey"
// ...(其餘 #define 略)
// 歸檔
- (void)encodeWithCoder:(NSCoder *)aCoder {
[aCoder encodeObject:self.CUSTID forKey:kCUSTIDKey];
[aCoder encodeObject:self.CUSTSTATUS forKey:kCUSTSTATUSKey];
// ...(每個屬性都要寫一行)
}
// 解檔
- (id)initWithCoder:(NSCoder *)decoder {
if (self = [super init]) {
self.CUSTID = [decoder decodeObjectForKey:kCUSTIDKey];
self.CUSTSTATUS = [decoder decodeObjectForKey:kCUSTSTATUSKey];
// ...(每個屬性都要寫一行)
}
return self;
}
@end
寫完會發現整個人都不好了:若物件屬性更多,這些重複性程式碼意味著要反覆 Command+C、Command+V 無數次,實在累人。
既然 Objective-C 執行期庫提供了便利的方法取得物件所屬類別及其所有成員變數,並可透過 KVC 進行值的存取,那麼不妨用 objc/runtime + KVC 來自動化。
先導入 #import <objc/runtime.h>,用來取得類別中所有屬性:
unsigned int count;
Ivar *varA = class_copyIvarList([MyModel class], &count);
for (unsigned int i = 0; i < count; i++) {
Ivar v = varA[i];
const char *name = ivar_getName(v);
NSLog(@"%s==", name);
}
接著利用 KVC 依屬性名稱取值:
id value = [self valueForKey:strName]; [encoder encodeObject:value forKey:strName];
最終改良後的程式碼:
#import "MyModel.h"
#import <objc/runtime.h>
@implementation MyModel
// 解檔
- (id)initWithCoder:(NSCoder *)decoder {
if (self = [super init]) {
unsigned int count = 0;
Ivar *ivar = class_copyIvarList([MyModel class], &count);
for (int i = 0; i < count; i++) {
Ivar iva = ivar[i];
const char *name = ivar_getName(iva);
NSString *strName = [NSString stringWithUTF8String:name];
id value = [decoder decodeObjectForKey:strName];
[self setValue:value forKey:strName];
}
free(ivar);
}
return self;
}
// 歸檔
- (void)encodeWithCoder:(NSCoder *)encoder {
unsigned int count;
Ivar *ivar = class_copyIvarList([MyModel class], &count);
for (int i = 0; i < count; i++) {
Ivar iv = ivar[i];
const char *name = ivar_getName(iv);
NSString *strName = [NSString stringWithUTF8String:name];
id value = [self valueForKey:strName];
[encoder encodeObject:value forKey:strName];
}
free(ivar);
}
@end
妥妥的,從此遠離重複,做開心寫程式的開發者!