後端回傳的 JSON 裡出現 null 是家常便飯,而 Objective-C 直接對 NSNull 送訊息、或把它塞進期待 NSString/NSArray 的變數,往往就是崩潰的起點。与其在每個地方重複寫 if 判斷,不如把這些防禦邏輯收攏到一個 NSDictionary 的分類裡。
#import <Foundation/Foundation.h> @interface NSDictionary (ObjectExt) /** 取得指定的 array;若為 nil 或 NSNull 則回傳空陣列 */ - (NSArray *)arrayObjectForKey:(id)aKey; /** 取得指定的 mutable array;若為 nil 或 NSNull 則回傳空陣列 */ - (NSMutableArray *)mutableArrayObjectForKey:(id)aKey; /** 取得指定物件;若為空則回傳自訂預設值 */ - (id)objectExtForKey:(id)aKey defaultObject:(id)defaultObject; /** 取得字串;找不到 key 時回傳 @"",避免 nil 造成崩潰 */ - (NSString *)stringForKey:(id)aKey; /** 取得字串;找不到 key 時回傳指定的預設值 */ - (NSString *)stringForKey:(id)aKey withDefaultValue:(NSString *)defValue; /** 把 替換為空白 */ - (NSString *)replaceNBSPforKey:(id)aKey; /** 取得數值型字串;若為 nil 或 NSNull 則回傳 @"0" */ - (NSString *)numberStringForKey:(id)aKey; @end
#import "NSDictionary+ObjectExt.h"
@implementation NSDictionary (ObjectExt)
- (NSArray *)arrayObjectForKey:(id)aKey {
id value = [self objectForKey:aKey];
if (value == nil || [value isKindOfClass:[NSNull class]]) {
return [NSArray array];
}
return value;
}
- (NSMutableArray *)mutableArrayObjectForKey:(id)aKey {
id value = [self objectForKey:aKey];
if (value == nil || [value isKindOfClass:[NSNull class]]) {
return [NSMutableArray array];
}
return value;
}
- (id)objectExtForKey:(id)aKey defaultObject:(id)defaultObject {
id value = [self objectForKey:aKey];
if (value == nil || [value isKindOfClass:[NSNull class]]) {
return defaultObject;
}
return value;
}
- (NSString *)stringForKey:(id)aKey {
return [self stringForKey:aKey withDefaultValue:@""];
}
- (NSString *)numberStringForKey:(id)aKey {
return [self stringForKey:aKey withDefaultValue:@"0"];
}
- (NSString *)stringForKey:(id)aKey withDefaultValue:(NSString *)defValue {
NSString *value = [self objectForKey:aKey];
if (value == nil || [value isKindOfClass:[NSNull class]]) {
value = defValue;
}
return [NSString stringWithFormat:@"%@", value];
}
- (NSString *)replaceNBSPforKey:(id)aKey {
NSString *value = [self objectForKey:aKey];
if (!value) { value = @""; }
NSString *str = [value stringByReplacingOccurrencesOfString:@" " withString:@" "];
return [NSString stringWithFormat:@"%@", str];
}
@end
之後只要把原本的 [dict objectForKey:key] 換成 [dict stringForKey:key]、[dict arrayObjectForKey:key],防禦就自動生效了:
NSString *name = [dic stringForKey:@"name"]; // 保證不為 nil NSArray *list = [dic arrayObjectForKey:@"list"]; // 保證可安全 for-in NSInteger count = [[dic numberStringForKey:@"count"] integerValue];
stringForKey: 內部用 stringWithFormat:@"%@" 包裝,能連「後端回傳數字而非字串」的情況一起吸收,這是個很實用的防禦手法。stringForKey: 而非直接改寫行為,實作時請延續這個命名原則以免與其他套件衝突。extension Dictionary 搭配泛型與 optional 綁定來達成,寫法更安全。