组件接口(API)设计指南[4]－通知(Notifications)

*返回目录阅读其他章节: http://blog.csdn.net/cuibo1123/article/details/39894477

通知(Notifications)

    通知是委托协议的另一半。我的立场是，如果你使用委托协议(你因该在所有适合的地方使用)，就添加一个同样功能的通知，以使它提供完整的委托／通知方案。

    在MGTileMenu中，你可以找到关于通知的接口文件：MGTileMenuController

规则23: 通知跟随委托方法

    在委托方法(适当的，不是数据源方法)和通知之间存在着天生的对应关系。你可以在你代码的任何地方使用他们，而达到完全相同的目的。

    如果你有一个关于事件发生的委托，你通常也应该提供一个同样目的的通知。做到即使把委托方法全部移除，使用者也依然可以通过通知来实现相应功能。

    委托方法的参数应该与通知的‘userInfo(通知附加值)’内容匹配，通知与您在委托中直接传递参数有一个明显的区别，它通常需要将信息装载到字典(NSDictionary)中。

    委托方法：

- (void)tileMenuWillDisplay:(MGTileMenuController *)tileMenu;
- (void)tileMenuDidDisplay:(MGTileMenuController *)tileMenu;

    相应的通知：

externNSString *MGTileMenuWillDisplayNotification;
externNSString *MGTileMenuDidDisplayNotification;

 

规则24: 不要吝啬‘userInfo(通知附加值)’ 

    给通知对象所需要的足够信息。请记住，通知接收器可能(几乎总是会)不持有委托或数据源组件的引用。

    问问自己什么是有用的，并提供相应信息。最起码，你必须确保提供给相应委托方法的参数都包含在了userInfo的对象中。

    委托方法：

- (void)tileMenu:(MGTileMenuController *)tileMenuwillSwitchToPage:(NSInteger)pageNumber;
- (void)tileMenu:(MGTileMenuController *)tileMenudidSwitchToPage:(NSInteger)pageNumber;

    相应的通知：

// 通知userInfo包含一个键"MGPageNumber"
#defineMGPageNumberKey @"MGPageNumber"
externNSString *MGTileMenuWillSwitchToPageNotification;
externNSString *MGTileMenuDidSwitchToPageNotification;

规则25: 测试的地狱

    最后，所有事情大家都已经知道了。软件工程专业化第101条：确保它确实可以工作。

    是否使用正式的TDD(测试驱动开发)取决于你，但测试本身是不可能做到全面的。每一个委托方法、每一个通知、每一个定制点所共同组成的千千万万种组合可能出现各种问题。

    出现缺陷，首先应该找到并修复他们。如果你在赶时间，可以裁切功能。你一定会对无bug上线的问题感到苦恼。

阅读下一章节: http://blog.csdn.net/cuibo1123/article/details/39894477

－－－－－－－－－－－－－－－－－－－－－－－－－

英文原名《API Design》
       作者：Matt Gemmell
       原名链接：http://mattgemmell.com/api-design/

中文版由xoneday翻译
       欢迎访问译者博客：http://blog.xoneday.com
       新浪微博：@xoneday某天

如果这片译文给您带来了帮助，希望您能通过下载我的APP来支持我：
豆瓣读书：https://itunes.apple.com/cn/app/id695492935
便签夹：https://itunes.apple.com/cn/app/id580552733

           

             便签夹                                        豆瓣读书

＊转载声明：请勿删减作者／译者信息与支持部分的内容，如不接受此条款请勿转载。