class_addProperty + class_addMethod 完全動態創建屬性適用於:運行時為現有類動態添加帶存儲的屬性(需手動實現 getter/setter 訪問實例變量)。
#import
#import
@interface SomeClass : NSObject {
NSString *_privateName; // 底層實例變量
}
@end
@implementation SomeClass
- (instancetype)init {
if (self = [super init]) _privateName = @"Steve";
return self;
}
@end
// 自定義 getter
NSString *nameGetter(id self, SEL _cmd) {
Ivar ivar = class_getInstanceVariable([SomeClass class], "_privateName");
return object_getIvar(self, ivar);
}
// 自定義 setter
void nameSetter(id self, SEL _cmd, NSString *newName) {
Ivar ivar = class_getInstanceVariable([SomeClass class], "_privateName");
id oldName = object_getIvar(self, ivar);
if (oldName != newName) object_setIvar(self, ivar, [newName copy]);
}
int main() {
@autoreleasepool {
// 定義屬性屬性:類型、所有權、備份實例變量
objc_property_attribute_t type = {"T", "@\"NSString\""};
objc_property_attribute_t ownership = {"C", ""}; // C = copy
objc_property_attribute_t backing = {"V", "_privateName"};
objc_property_attribute_t attrs[] = {type, ownership, backing};
// 1. 添加屬性
class_addProperty([SomeClass class], "name", attrs, 3);
// 2. 添加 getter/setter
class_addMethod([SomeClass class], @selector(name), (IMP)nameGetter, "@@:");
class_addMethod([SomeClass class], @selector(setName:), (IMP)nameSetter, "v@:@");
// 驗證
id obj = [SomeClass new];
NSLog(@"%@", [obj name]); // Steve
[obj setName:@"Jobs"];
NSLog(@"%@", [obj name]); // Jobs
}
return 0;
}
屬性屬性鍵值對照:T=類型編碼、C=copy、&=retain、N=nonatomic、V=實例變量名、R=readonly。
valueForUndefinedKey: / setValue:forUndefinedKey: 攔截未定義鍵利用 KVC 機制,在分類中重寫這兩個方法,實現「虛擬屬性」:
@interface NSObject (DynamicProperty)
@end
@implementation NSObject (DynamicProperty)
- (id)valueForUndefinedKey:(NSString *)key {
if ([key isEqualToString:@"dynamicTitle"]) return @"動態標題";
return [super valueForUndefinedKey:key];
}
- (void)setValue:(id)value forUndefinedKey:(NSString *)key {
if ([key isEqualToString:@"dynamicTitle"]) {
NSLog(@"設置動態標題:%@", value);
} else {
[super setValue:value forUndefinedKey:key];
}
}
@end
優點:無需修改類定義、無需實例變量;缺點:僅限 KVC 訪問、無法參與編譯期檢查、性能略低。
最推薦、最常用。利用 objc_setAssociatedObject / objc_getAssociatedObject 在分類中為現有類添加帶存儲的屬性。
static char const * const ObjectTagKey;
@implementation NSObject (ExampleCategoryWithProperty)
@dynamic objectTag; // 告訴編譯器不自動合成實例變量
- (id)objectTag {
return objc_getAssociatedObject(self, ObjectTagKey);
}
- (void)setObjectTag:(id)newObjectTag {
objc_setAssociatedObject(self, ObjectTagKey, newObjectTag, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
// 關聯策略:RETAIN_NONATOMIC / COPY_NONATOMIC / ASSIGN 等
}
@end
關鍵點:
static char const * const Key 保證鍵唯一且地址穩定@dynamic 明確聲明手動實現存取方法OBJC_ASSOCIATION_RETAIN| 場景 | 推薦方案 | 理由 |
|---|---|---|
| 為第三方/系統類添加存儲屬性 | 關聯對象 (方案三) | 無侵入、線程安全、內存管理自動、API 穩定 |
| 極度動態:屬性名/類型運行時才確定 | 方案一 | 完全運行時構建,適合框架底層 |
| 簡單 KVC 訪問攔截、默認值、日誌 | 方案二 | 輕量、無存儲需求時足夠 |