兩個問題帶我們進入主題:為什麼需要自訂 dictionary 的 key?系統對自訂 key 又有什麼要求?
我遇到的實際場景是一個三級選單(省/市/區),每一層都需要記錄「是否被選中」。用三個小 table view 實作時,需要一個能同時表達「節點身份」與「勾選狀態」的資料結構,而單純的字串 key 無法承載狀態。最後的選擇是用一整個字典,以模型物件作為 key。
要能當 key,物件必須做到兩件事:實作 NSCopying 協定的 copyWithZone:,以及重寫 isEqual:(並搭配 hash)。原因在於字典在插入 key 時會複製一份保存,而查找時則靠 hash 定位、isEqual: 確認。
#import <Foundation/Foundation.h>
// 必須在 .h 就宣告遵循 NSCopying,否則編譯器檢查不到
@interface AreaModel : NSObject <NSCopying>
@property (nonatomic, copy) NSString *areaString;
@property (nonatomic, copy) NSString *areaIDString;
@property (nonatomic, assign) BOOL isSelected;
@end
#import "AreaModel.h"
@interface AreaModel ()
// 用來判定兩個物件是否代表同一個實體
@property (nonatomic, assign) NSUInteger myHash;
@end
@implementation AreaModel
#pragma mark -- <NSCopying>
- (id)copyWithZone:(nullable NSZone *)zone
{
AreaModel *areaModel = [[[self class] allocWithZone:zone] init];
// 物件屬性用 copyWithZone,基礎型別直接賦值
areaModel.areaString = [self.areaString copyWithZone:zone];
areaModel.areaIDString = [self.areaIDString copyWithZone:zone];
areaModel.isSelected = self.isSelected;
areaModel.myHash = self.myHash;
return areaModel;
}
- (id)init
{
self = [super init];
if (self) {
// 以記憶體位址作為唯一識別值
_myHash = (NSUInteger)self;
}
return self;
}
- (NSUInteger)hash
{
return _myHash;
}
- (BOOL)isEqual:(id)object
{
return self.myHash == ((AreaModel *)object).myHash;
}
// 方便除錯時閱讀
- (NSString *)description
{
return [NSString stringWithFormat:@"<%@: %p; area = %@; areaID = %@; isSelected = %@>",
self.class, self, self.areaString, self.areaIDString,
self.isSelected ? @"YES" : @"NO"];
}
@end
AreaModel *pModel1 = [AreaModel new];
pModel1.areaString = @"安徽省";
pModel1.areaIDString = @"01";
AreaModel *cModel1 = [AreaModel new];
cModel1.areaString = @"合肥市";
cModel1.areaIDString = @"0101";
AreaModel *aModel1 = [AreaModel new];
aModel1.areaString = @"弋江區";
aModel1.areaIDString = @"010201";
aModel1.isSelected = YES;
NSDictionary *dictionary = @{
pModel1 : @{
cModel1 : @[],
cModel2 : @[aModel1]
},
pModel2 : @{}
};
hash 與 isEqual: 必須成對實作,且兩者邏輯要一致:若 isEqual: 判定相等,hash 就必須回傳相同值,否則字典查詢會出現「明明放進去了卻找不到」的怪現象。
另外,以記憶體位址作為識別值雖然簡單,但有個副作用:物件一旦銷毀、記憶體位址被新物件重用,舊的查表結果就可能指向錯誤的實體。若你的資料會動態增刪,改用 areaIDString 這類業務唯一鍵會更可靠。最後,別忘了在 isEqual: 中先判斷 object 是否為 nil 或型別不符,避免 nil 被當成合法比較對象。