设计Public API

为Library设计Public API, 是一件非常困难的事。

设计Public API, Interface, 命名API, Interface 相当于给你的小孩取名一样。

主要原则是:
1. 易简单

2. 名字易清晰
可以稍微长一点,而不让使用这个API的程序员糊涂。
用长度来换取清晰,是可取的。

4. 通用方式
Action + Object
Action + 形容词 + Object
Action + 形容词 + Object + 副词
以及这样形式的多种组成.


如: DrawLine, WaitOneObject, beginthreadex


3. 大小写标准
internal api, 多半为:  _APIName
public API 前面多半不加: _
形式多半为:  WordWordWord ... 的形式
每个词的首字母大写.


4. 参数不易多
参数多半在 0~8个之间。


5. 多重重载引出的多样参数
如果使用GDI+, 可以使用DrawImage, 有15种以上之多的参数形式。

 

  • 0
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值