您现在的位置: IOS教程網 >> IOS系統 >  >> iOS 訊息 >> iOS 相關資訊

iOS 屬性反射:用 objc_property_t 自動完成物件賦值

編輯:iOS 相關資訊

所謂屬性反射,說白了就是:把兩個物件的屬性用動態方式取出來,依屬性名稱自動完成對應的值綁定。

最常見的兩個應用場景:

  1. 自訂實體類 → 自訂實體類:兩個結構相同的 model 之間搬資料。
  2. NSDictionary → 自訂實體類:這是最實用的一種。網路請求回來的 JSON 組成 NSDictionary 之後,用反射一次灌進 model;SQLite 查詢結果經第三方元件組成 NSDictionary 後也同理。

一個限制要先講清楚:反射拿到的只有當前類別本身宣告的屬性。若你的類別是派生類,class_copyPropertyList 不會回傳父類的屬性,需要另外沿著繼承鏈往上遞迴處理。

程式碼

以下寫在 NSObject 的分類(Category)裡,讓所有物件都能用:

// 取得當前物件的所有屬性名稱
- (NSArray *)propertyKeys {
    unsigned int outCount, i;

    objc_property_t *properties = class_copyPropertyList([self class], &outCount);
    NSMutableArray *keys = [[NSMutableArray alloc] initWithCapacity:outCount];

    for (i = 0; i < outCount; i++) {
        objc_property_t property = properties[i];
        NSString *propertyName =
            [NSString stringWithUTF8String:property_getName(property)];
        [keys addObject:propertyName];
    }

    free(properties);   // class_copyPropertyList 的結果必須自己 free
    return keys;
}


// 從另一個物件(或 NSDictionary)反射賦值
- (BOOL)reflectDataFromOtherObject:(NSObject *)dataSource {
    BOOL ret = NO;

    for (NSString *key in [self propertyKeys]) {
        if ([dataSource isKindOfClass:[NSDictionary class]]) {
            ret = ([dataSource valueForKey:key] == nil) ? NO : YES;
        } else {
            ret = [dataSource respondsToSelector:NSSelectorFromString(key)];
        }

        if (ret) {
            id propertyValue = [dataSource valueForKey:key];

            // 該值不為 NSNull,也不為 nil,才真的寫入
            if (![propertyValue isKindOfClass:[NSNull class]] && propertyValue != nil) {
                [self setValue:propertyValue forKey:key];
            }
        }
    }
    return ret;
}

使用方式

NSDictionary *dicJsonData;      // 來自網路或資料庫
EntityObject *objValue = [[EntityObject alloc] init];

[objValue reflectDataFromOtherObject:dicJsonData];

// 你還在用下面這種一行一行寫的寫法嗎?
objValue.value = [dicJsonData objectForKey:@"value"];
// 太 out 了!

幾個實務上會踩到的細節

  • class_copyPropertyList 回傳的是 C 陣列,必須 free。ARC 不管這塊記憶體,漏掉就是洩漏。
  • property_getName 回傳的是 C 字串,要轉成 NSString 才能放進陣列。若屬性名稱可能含非 ASCII 字元,改用 property_getAttributes 或 stringWithCString:encoding: 明確指定編碼。
  • NSNull 防護是必要的。JSON 裡的 null 會被解析成 NSNull 單例,直接塞進 model 之後,任何當它是普通物件用的程式碼都會崩潰。這段程式已經處理掉了。
  • 型別不符時 KVC 會丟例外。例如 JSON 給的是 NSString 而屬性宣告為 NSInteger,setValue:forKey: 會直接 crash。若要 production 級的健壯性,建議在寫入前用 class_getPropertyType 或自行維護的型別對照表做一次轉換。
  • 它依賴 KVC 的 key 與屬性名稱一致。一旦後端欄位名採用 snake_case 而你的 model 用 camelCase,就得先做一次 key 對照,反射本身不會幫你翻譯。

要不要在專案裡用

反射的價值在於消滅大量樣板程式碼——幾十個欄位的 model 不必逐一寫賦值。但它也把編譯期的型別檢查換成了執行期的動態查找,錯誤會晚一點才爆。

實務上的折衷是:小型專案直接用上面的寫法,夠快夠乾淨;中大型專案則建議改用 YYModel、Mantle 這類成熟方案,或自 iOS 13 起直接用 Codable 的 JSONDecoder。它們同樣是反射/動態機制,但把型別轉換、鍵名對照、巢狀物件與陣列、日期格式等邊界情況都處理過了,這些正是自己寫反射最花時間的部分。

不管用哪一種,記得把「後端欄位型別與 model 屬性不一致」列進你的防禦清單——這是這類動態賦值方案唯一但致命的弱點。

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