objc 关键字之 NS_UNAVAILABLE 和 NS_DESIGNATED_INITIALIZER

NS_UNAVAILABLE

简介

NS_UNAVAILABLE将方法标记为不可用，在类外调用该方法时会直接报错，提示'someMethod' is unavailable。但其实这个方法还能通过一些其他方式调用，比如performSelector

用处

• 禁用NSObject的init或者new方法，让开发者只能使用指定的初始化函数。

+ (instancetype)new NS_UNAVAILABLE;
- (instancetype)init NS_UNAVAILABLE;
- (instancetype)initWithFrame:(CGRect)frame NS_UNAVAILABLE;
- (instancetype)initWithParam:(NSString *)param;	// 只能用这个方法初始化

• 整理代码的时候将某个方法标记为不可用，最后再把它删掉。

- (instancetype)init NS_UNAVAILABLE;
- (instancetype)init __attribute__((unavailable));	// 效果等同于 NS_UNAVAILABLE
- (instancetype)init __attribute__((unavailable("请使用initWithParam:")));

NS_DESIGNATED_INITIALIZER

NS_DESIGNATED_INITIALIZER将方法标记为designed initializer（指定初始化方法）。无论调用哪种初始化方法，最终都应该调用designed initializer

- (instancetype)initWithParam:(NSString *)param NS_DESIGNATED_INITIALIZER;

将initWithParam:设为指定初始化方法后，NSObject自带的- (instancetype)init初始化方法就变成了convenience initializer，在它内部需要调用initWithParam:方法

总结

NS_UNAVAILABLE 和 NS_DESIGNATED_INITIALIZER一个主外、一个主内，能够帮我们约束初始化方式，使接口描述更加清晰