API设计
iteye_10829
这个作者很懒,什么都没留下…
展开
-
API设计
一、优秀的API具有哪些特征: 1、易学易记; 2、可读性高; 3、不容易用错; 4、容易扩展; 5、具有完整性:用户通过API能去做想做的事情,但是这是比较困难的。即便如此,至少也应该方便扩展和定制化(例如通过继承等等)。当然,设计一个完整的API这可能需要一个过程,但起码得保证有一个清晰的设计思路,或者在朝着正确的方向迈出的一步,因为并不是每一个API从最开始就是很完美的。 ...原创 2011-11-16 23:58:23 · 164 阅读 · 0 评论 -
不要在API中使用magic number
在源代码编写中,用这么一种情况:编码者在写源代码的时候,使用了一个数字,比如0x2123,0.021f等,他当时是明白这个数字的意思的,但是别的 程序员看他的代码,可能很难理解,甚至,过了一段时间,代码的作者自己再看代码的时候也忘记了这个数字代表的含义.于是感叹,虽然不知道这个数字是干什么用的,究竟代表什么,但是编译后的程序可以正常运行,真是"魔术般的数字"啊,magic number 即源于此...原创 2011-11-17 00:12:18 · 354 阅读 · 0 评论