好接口的设计与实现
来源:互联网 发布:python绘图 编辑:程序博客网 时间:2024/06/14 05:50
一、好接口的特性
- 易读
- 易用,难于误用
- 功能独立
- 容易扩展
二、好接口设计的基本原则
- 只做并做好一件事
函数名自解释
不恰当的函数名,往往是不恰当设计的征兆- 如果没做到上一点,就将函数分解
只增加,永远不要删除函数与接口(你永远不知道这个接口被谁在使用)- 实现永远不能影响接口
举例:不能假定函数调用者只能使用hash
不能对外暴露实现细节- 最小化访问
尽量使用私有化成员
注意信息隐藏- 注意文档与注释
接口不是只写给自己(即使只给自己,也应该有说明)
三、好接口实现的基本原则
- 不要到处拷贝代码
- 原子性尽量在一个接口内保证
- Fail-Fast原则
出错尽量早点返回,交给上层处理,不要勉强抢救- 避免数据直接访问,而是提供访问方法
- 注意参数与返回值类型
尽量明确类型
能不用string尽量不用
使用float的地方尽量用double,64bit- 参数个数不宜太多
如果过多,就要考虑接口的合理性了
阅读全文
0 0
- 好接口的设计与实现
- 一分钟了解“好”接口的设计与实现
- 基于AX88796B的网络接口模块的设计与实现
- 基于FPGA的以太网MII接口扩展设计与实现
- 嵌入式指纹自动识别系统USB接口的设计与实现
- 基于ARM和DM9000的网卡接口设计与实现
- ARM和DM9000的网卡接口设计与实现
- Hadoop之InputFormat接口的设计与实现
- Atitit 通用接口的设计与实现attilax 总结
- Atitit 通用接口的设计与实现attilax 总结
- 继承与接口的好坏处
- Win32 调试接口设计与实现浅析
- Win32 调试接口设计与实现浅析
- Win32 调试接口设计与实现浅析
- Win32 调试接口设计与实现浅析
- C程序接口设计与实现-----原子
- C++设计:接口与实现分离
- app开放接口签名设计与实现
- 打印菱形
- 软件设计方案
- STL-Lesson004_002
- 查看Nginx、apache、MySQL和PHP的编译参数
- keil5 STM32 浮点数转字符串跑飞
- 好接口的设计与实现
- keil STM32 hex转浮点数及浮点数转字符串较好方案
- STL_Lesson005_001
- Leetcode 题解系列(十二)
- 戴尔7447 win10安装Ubuntu双系统
- HQL补充知识点
- 测试通过HTTP请求依赖其它服务的系统
- Keil5无法使用Jlink
- STL_Lesson005_002