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
一个主外、一个主内,能够帮我们约束初始化方式,使接口描述更加清晰