一分钟了解“好”接口的设计与实现

一、好接口的特性

(1) 易读

(2) 易用，难于误用

(3) 功能独立

(4) 容易扩展

二、好接口设计的基本原则

(1) 只做并做好一件事

函数名自解释
不恰当的函数名，往往是不恰当设计的征兆

(2) 如果没做到上一点，就将函数分解

只增加，永远不要删除函数与接口(你永远不知道这个接口被谁在使用)

(3) 实现永远不能影响接口

举例：不能假定函数调用者只能使用hash
不能对外暴露实现细节

(4) 最小化访问

尽量使用私有化成员
注意信息隐藏

(5) 注意文档与注释

接口不是只写给自己(即使只给自己，也应该有说明)

三、好接口实现的基本原则

(1) 不要到处拷贝代码

(2) 原子性尽量在一个接口内保证

(3) Fail-Fast原则

出错尽量早点返回，交给上层处理，不要勉强抢救

(4) 避免数据直接访问，而是提供访问方法

(5) 注意参数与返回值类型

尽量明确类型
能不用string尽量不用
使用float的地方尽量用double，64bit

(6) 参数个数不宜太多

如果过多，就要考虑接口的合理性了

【本文为专栏作者“58沈剑”原创稿件，转载请联系原作者】

戳这里，看该作者更多好文

网站名称：一分钟了解“好”接口的设计与实现
URL链接：http://www.xwwzsj.com/article/djgsddh.html

其他资讯

售后响应及时

7×24小时客服热线

数据备份

更安全、更高效、更稳定

价格公道精准

项目经理精准报价不弄虚作假

合作无风险

重合同讲信誉，无效全额退款

瑞达杰昌建站工作室是一家专注从事于高品质视觉体验及互联网设计开发，宣威网站建设，宣威网站设计，宣威网页设计，宣威网站制作，品牌网站建设，营销网站建设，集团网站建设，企业网站建设，外贸网站建设，响应式网站建设，小程序开发，微信开发，企业形象设计，企业宣传视频等服务，瑞达杰昌建站位于宣威市龙岗区大运软件小镇，瑞达杰昌建站拥有经验丰富的高级网站建设工程师和一流的网页高端设计人员，具备各种规模与类型网站建设的雄厚实力，在网站建设领域树立了自己独特的设计风格。

友情链接交换友情链接

bgp多线机房托管成都翻译公司成都灯箱制作成都汽油发电机建站公司礼盒包装设计成都集团网站建设德阳网站维护昆明实木家具定制成都实验室超纯水机

Copyright © 2025 青羊区瑞达杰昌互联网信息服务工作室（个体工商户）宣威建站 All Rights Reserved 蜀ICP备2025133229号-6

Copyright © 2025 青羊区瑞达杰昌互联网信息服务工作室（个体工商户）宣威建站

蜀ICP备2025133229号-6