规则1:使用当前平台的描述用语或构架
一个最常见的API错误设计是使用外来的规则,API属于一个特定的平台和相关开发者生态系统。你不能使用任何其他不同平台的描述用语或构架,这会污染你当前的代码库,并破坏你同伴的工作效率。
在编码前要充分了解你的目标平台和代码规范。例如,在IOS和OSX中,不使用异常机制处理错误。统一命名规则(规则要足够详细,但是也要足够简洁)。
了解什么是协议(protocol),委托(delegate),扩展(category)。始终在你的代码中使用术语。遵守构造...
组件接口(API)设计指南-目录;
组件接口(API)设计指南[1]-要考虑的问题;
组件接口(API)设计指南[2]-类接口(class interface);
组件接口(API)设计指南[3]-委托(delegate)和数据源协议(data-source protocols);
组件接口(API)设计指南[4]-通知(Notifications);
组件接口(API)设计指南[5]-最后的思考;...
开发人员与组件的显式交互主要有四种:
1. 类接口(classinterface),类公开的属性和方法。
2.委托协议(delegateprotocol),在相关的地方。
3.数据源协议(data-sourceprotocol),酌情。
4.规定的通知(notifications)。
我们设计的每一种交互,都应该需要用户刻意的去使用,不要做隐式的交互调用。另外,你应当思考两个关键问题:
○ 什么是控制?
控制会影响界面和类方法。它影响的界面是显而易见的,比如一个按钮,或者一个滑块。而...
迭代器有时又称光标(cursor)是程式设计的软件设计模式,可在容器物件(container,例如list或vector)上遍访的接口,设计人员无需关心容器物件的内容。各种语言实作Iterator的方式皆不尽同,有些面向对象语言像Java, C#, Python, Delphi都已将Iterator...
分类:
其他好文 时间:
2014-09-23 10:56:24
阅读次数:
204
一年多来,在工作中设计完成过大量的HTTP API,本文对工作过程中得出的经验和心得做一个总结,一来对自己有所提高,同时希望对大家能有所帮助。
分类:
其他好文 时间:
2014-09-15 14:10:58
阅读次数:
869
一个大的项目必须要先有设计,一定要先设计,而设计之前必须要做的事情就是需求分析。需求分析是了解用户“做什么”,需求分析包括了解功能和性能需求,只有了解了用户的需求以后再设计才能保证在项目完工后返工的现象发生。
设计阶段包括四个方面:数据设计,系统结构设计,过程设计,接口设计。
结构设计:定义软件系统各主要部件之间的关系。
数据设计:将模型转换成数据结构...
分类:
其他好文 时间:
2014-09-10 21:09:31
阅读次数:
170
教科书上早就告诉了我们面向接口的好处是什么。但是怎么深刻滴理解面向接口的好处呢? 在这里我举一个dubbo的例子,完完整整地告诉你面向接口有什么好处。 首先定义interface ?package?com.alibaba.dubbo.demo;...
分类:
其他好文 时间:
2014-09-05 18:33:32
阅读次数:
362
前段时间项目中用到了下拉刷新功能,之前在网上也找到过类似的demo,但这些demo的质量参差不齐,用户体验也不好,接口设计也不行。最张没办法,终于忍不了了,自己就写了一个下拉刷新的框架,这个框架是一个通用的框架,效果和设计感觉都还不错,现在分享给各位看官。致谢:1. 感谢lk6233160同学提出的...
分类:
移动开发 时间:
2014-09-02 11:52:14
阅读次数:
312
迭代器(iterator) 有时又称游标(cursor)是程式设计的软件设计模式,可在容器物件(container,例如链表或阵列)上遍访的接口,设计人员无需关心容器物件的内容。 在python中,对迭代器的定义是为类似序列的对象提供了一个具有序列特性的接口。它是在python2.2版本中引进进.....
分类:
编程语言 时间:
2014-08-26 19:05:56
阅读次数:
234