Associated Objects(关联对象)

#import <objc/runtime.h>

Objective-C开发者应该小心谨慎地遵循这个危险咒语的各种准则。一个很好的原因的就是：混乱的运行时代码会改变运行在其架构之上的所有代码。

从利的角度来讲， <objc/runtime.h> 中的函数具有其他方式做不到的、能为应用和框架提供强大功能的能力。而从弊的角度来讲，它可能会会毁掉代码的sanity meter，一切代码和逻辑都可能被异常糟糕的副作用影响(terrifying side-effects)。

因此，我们怀着巨大的恐惧来思考这个与“魔鬼的交易”(Faustian bargain)，一起来看看这个最多地被NSHipster读者们要求讲讲的主题之一：对象关联（associated objects）。

• objc_setAssociatedObject : void objc_setAssociatedObject(id object, void*key, id value,objc_AssociationPolicy policy)
• objc_getAssociatedObject : void objc_getAssociatedObject(id object, void*key)
• objc_removeAssociatedObjects : void objc_removeAssociatedObjects(id object)

为什么我说这个很有用呢？因为这允许开发者对已经存在的类在扩展(category)中添加自定义的属性，这几乎弥补了Objective-C最大的缺点。

PS:在《Effective objective-c 2.0》中第26条中作者谈到了 勿在类的扩展（category）中声明属性。因为类的扩展目的在于扩展功能，而非封装数据。在category扩展类中声明的属性，此扩展类无法合成与该属性的存取方法。此时可以把该属性声明为@dynamic，以表示由用户自己实现，不需要自动合成，然后通过关联对象来实现该属性的存取方法。如下例所示：

NSObject+AssociatedObject.h

@interface NSObject (AssociatedObject)
@property (nonatomic, strong) id associatedObject; //category中的属性
@end

NSObject+AssociatedObject.m

@implementation NSObject (AssociatedObject)
@dynamic associatedObject;

- (void)setAssociatedObject:(id)object {
     objc_setAssociatedObject(self, @selector(associatedObject), object, OBJC_ASSOCIATION_RETAIN_NONATOMIC);
}

- (id)associatedObject {
    return objc_getAssociatedObject(self, @selector(associatedObject));
}

通常推荐的做法是添加的属性最好是 static char 类型的，当然更推荐是指针型的（static const char *kNsobjectPropertyKey = "kNsobjectPropertyKey"）。通常来说该属性应该是常量、唯一的、在适用范围内用getter和setter访问到：

static char kAssociatedObjectKey;

objc_getAssociatedObject(self, &kAssociatedObjectKey);

然而可以用更简单的方式实现：用selector。

Since SELs are guaranteed to be unique and constant, you can use _cmd as the key forobjc_setAssociatedObject(). #objective-c #snowleopard   _cmd代表当前方法的SEL指针，可以通过NSStringFromSelector(_cmd)方法获取该方法的名字。

— Bill Bumgarner (@bbum) August 28, 2009

关联对象的行为

属性可以根据定义在枚举类型 objc_AssociationPolicy 上的行为被关联在对象上：

以 OBJC_ASSOCIATION_ASSIGN 类型关联在对象上的弱引用不代表0 retian的 weak 弱引用，行为上更像 unsafe_unretained 属性，所以当在你的视线中调用weak的关联对象时要相当小心。

根据WWDC 2011, Session 322 (第36分钟左右)发布的内存销毁时间表，被关联的对象在生命周期内要比对象本身释放的晚很多。它们会在被 NSObject -dealloc 调用的object_dispose() 方法中释放。

删除属性

你可以会在刚开始接触对象关联时想要尝试去调用 objc_removeAssociatedObjects() 来进行删除操作，但如文档中所述，你不应该自己手动调用这个函数：

The main purpose of this function is to make it easy to return an object to a "pristine state”. You should not use this function for general removal of associations from objects, since it also removes associations that other clients may have added to the object. Typically you should use objc_setAssociatedObject with a nil value to clear an association.

优秀样例(Patterns)

• 添加私有属性用于更好地去实现细节。当扩展一个内建类的行为时，保持附加属性的状态可能非常必要。注意以下说的是一种非常教科书式的关联对象的用例：AFNetworking在UIImageView 的category上用了关联对象来保持一个operation对象，用于从网络上某URL异步地获取一张图片。
  • @property (readwrite, nonatomic, strong, setter = af_setImageRequestOperation:) AFHTTPRequestOperation *af_imageRequestOperation;

    - (AFHTTPRequestOperation *)af_imageRequestOperation {

    return (AFHTTPRequestOperation *)objc_getAssociatedObject(self, @selector(af_imageRequestOperation));

    }

    - (void)af_setImageRequestOperation:(AFHTTPRequestOperation *)imageRequestOperation {

    objc_setAssociatedObject(self, @selector(af_imageRequestOperation), imageRequestOperation, OBJC_ASSOCIATION_RETAIN_NONATOMIC);

    }

• 添加public属性来增强category的功能。有些情况下这种(通过关联对象)让category行为更灵活的做法比在用一个带变量的方法来实现更有意义。在这些情况下，可以用关联对象实现一个一个对外开放的属性。回到上个AFNetworking的例子中的 UIImageView category，它的imageResponseSerializer方法允许图片通过一个滤镜来显示、或在缓存到硬盘之前改变图片的内容。
• 创建一个用于KVO的关联观察者。当在一个category的实现中使用KVO时，建议用一个自定义的关联对象而不是该对象本身作观察者。When using KVO in a category implementation, it is recommended that a custom associated-object be used as an observer, rather than the object observing itself.

反例(Anti-Patterns)

• 当值不需要的时候建立一个关联对象。一个常见的例子就是在view上创建一个方便的方法去保存来自model的属性、值或者其他混合的数据。如果那个数据在之后根本用不到，那么这种方法虽然是没什么问题的，但用关联到对象的做法并不可取。
• 当一个值可以被其他值推算出时建立一个关联对象。例如：在调用cellForRowAtIndexPath: 时存储一个指向view的 UITableViewCell 中accessory view的引用，用于在 tableView:accessoryButtonTappedForRowWithIndexPath: 中使用。
• 用关联对象替代X，这里的X可以代表下列含义：
  • 当继承比扩展原有的类更方便时用子类化。
  • 为事件的响应者添加响应动作。
  • 当响应动作不方便使用时使用的手势动作捕捉。
  • 行为可以在其他对象中被代理实现时要用代理(delegate)。
  • 用NSNotification 和 NSNotificationCenter进行松耦合化的跨系统的事件通知。 * * *

比起其他解决问题的方法，关联对象应该被视为最后的选择（事实上category也不应该作为首选方法）。

和其他精巧的trick、hack、workaround一样，一般人都会在刚学习完之后乐于寻找场景去使用一下。尽你所能去理解和欣赏它在正确使用时它所发挥的作用，同时当你选择这个解决办法时，也要避免当被轻蔑地问起“这是个什么玩意？”时的尴尬。

Associated Objects(关联对象)