objc 关键字之 NS_UNAVAILABLE 和 NS_DESIGNATED_INITIALIZER

NS_UNAVAILABLE

简介

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

用处

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