前言
工作的这一年多时间里我见识了各种通知的写法,今天总结一下。
第一种:
最纯粹的,如:
1[[NSNotificationCenter defaultCenter] postNotificationName:@"aNotification"object:nil];
第二种:
在PCH文件中写宏,如:
1#define aNotification @"aNotification"
第三种:
写在.h文件中,如:
1staticNSString *constaNotification = @"aNotification";
第四种:
在.m中定义并且在.h中暴露出来,如:
.h文件:
1extern NSString *constaNotification;
.m文件:
1NSString *constaNotification = @"aNotification";
思考
除了第一种low到爆之外其余三种貌似都可以,但是最好的只有一种,哪种最好呢?
《禅与Objective-C编程艺术》里面提到:
当你定义你自己的 NSNotification 的时候你应该把你的通知的名字定义为一个字符串常量,就像你暴露给其他类的其他字符串常量一样。你应该在公开的接口文件中将其声明为 extern 的, 并且在对应的实现文件里面定义。
因为你在头文件中暴露了符号,所以你应该按照统一的命名空间前缀法则,用类名前缀作为这个通知名字的前缀。
同时,用一个 Did/Will 这样的动词以及用 "Notifications" 后缀来命名这个通知也是一个好的实践。
如:
// Foo.h
extern NSString *constZOCFooDidBecomeBarNotification
// Foo.m
NSString *constZOCFooDidBecomeBarNotification = @"ZOCFooDidBecomeBarNotification";
抛开命名规范来说,这与上面提到的第四种写法一样,那么这样写的依据是什么?
官方文档推荐的是:
Notifications are identified by global NSString objects whose names are composed in this way:
1[Name of associatedclass] + [Did | Will] + [UniquePartOfName] + Notification
For example:
NSApplicationDidBecomeActiveNotification
NSWindowDidMiniaturizeNotification
NSTextViewDidChangeSelectionNotification
NSColorPanelColorDidChangeNotification
官方文档明确的告诉了我们通知如何命名,但是并没有告诉我们通知写到哪,既然如此就看看苹果的API吧。
苹果自己的API:
UIKIT_EXTERN NSNotificationNameconstUITextFieldTextDidBeginEditingNotification;
UIKIT_EXTERN NSNotificationNameconstUITextFieldTextDidEndEditingNotification;
UIKIT_EXTERN NSNotificationNameconstUITextFieldTextDidChangeNotification;
这是UITextField.h文件里的内容,是不是一看就觉得逼格很高?和《禅与Objective-C编程艺术》里的写法一样,在.m中定义然后在.h中暴露出去,但是它用到了UIKIT_EXTERN和NSNotificationName这两个我并没用用到的单词(姑且叫单词吧。。。)
按理说我们遵循官方文档再仿照苹果API就可以写出完美的通知了,但是,UIKIT_EXTERN和NSNotificationName这两个单词我们能随便用吗?
先看看UIKIT_EXTERN是什么:
#ifdef __cplusplus
#define UIKIT_EXTERN extern"C"__attribute__((visibility ("default")))
#else
#define UIKIT_EXTERN extern __attribute__((visibility ("default")))
#endif
是个宏定义,看不懂。
看不懂可以百度,百度之后大概了解了:
UIKIT_EXTERN简单来说,就是将函数修饰为兼容以往C编译方式的、具有extern属性(文件外可见性)、public修饰的方法或变量库外仍可见的属性。
UIKIT_EXTERN只是在extern的基础上增加了兼容性(不知道这样描述可以不),说明我们是可以使用的。
再看看NSNotificationName
typedef NSString *NSNotificationName NS_EXTENSIBLE_STRING_ENUM;
其实就是NSString *,我们当然可以用。
用NSNotificationName代替NSString *的好处是什么?直观。别人一看到NSNotificationName就知道你这是在定义一个通知。
拿两个相同的通知对比一下就清楚了:
UIKIT_EXTERN NSString *constZOCCacheControllerDidClearCacheNotification;
UIKIT_EXTERN NSNotificationNameconstZOCCacheControllerDidClearCacheNotification;
总结
结合《禅与Objective-C编程艺术》+官方文档+苹果API可以得出:
通知应该这样写:
1.命名符合通知专用格式
1[Name of associatedclass] + [Did | Will] + [UniquePartOfName] + Notification
2.在.m中定义,并且在.h中暴露。
这是苹果API里的一个通知,是模板,以后就照着模板写吧:
1UIKIT_EXTERN NSNotificationNameconstUITextFieldTextDidChangeNotification;
最后提供一个完整模板
// Foo.h
UIKIT_EXTERN NSNotificationNameconstZOCFooDidBecomeBarNotification
// Foo.m
NSNotificationNameconstZOCFooDidBecomeBarNotification = @"ZOCFooDidBecomeBarNotification";