欢迎访问郑州APP开发公司网站

黑网客咨询电话:15378763033

黑网客咨询电话

15378763033
您当前的位置:app开发公司 > 软件开发资讯 > 技术分享 > API设计的十大原则

API设计的十大原则

发表时间:2021-08-20 10:51:52

 1.只做你今天需要的

这是最顶级的规则,只解决今天必须解决的问题,最小化需要完成的答案。解决明天的问题的诱惑力是巨大的,但是一定要顶住诱惑!不要提前发布代码,重点是注重缩小发布周期。如果需要花几个小时的时间来回答新问题,那么就不用再猜测明天会出现什么问题了。
 
2.API模块化
将大型问题转化为规模较小的、可单独解决的问题。模块化API更容易学习,并且可以随时间而改变。你可以用新模块替代旧模块,可以一个一个地教导模块,也可以将API的实验部分从稳定或传统的部分中单独分出来。
 
3.使用结构化语法
使用结构化的API语法:用thing.action或thing.property代替do_action_with_thing。语法将自然而然地适应模块化的方法,其中每个模块是一个类。
 
4.使用自然语义
不要发明新概念,只使用开发人员众所周知的概念,作为类系系统的基础。如果你发现自己需要解释概念,那说明你出错了:要么你在解决以后的问题,要么你正在错误地构建API。
 
5.API的自我约定
每个类都要严格使用相同的样式和约定,一致性是指当一个人学会这一个类时,他就能够融会贯通地掌握全部的类。文档化约定,让它们成为贡献者必须的标准。
 
6.API的可扩展性
易扩展性有许多好处,并不仅仅在于受到贡献者的欢迎。它还可以让你延缓实现功能,因为“如果需要的话,后面再添加也很方便”。不需要的功能就不添加,这也是一种双赢。
 
7.完全测试
每个类和方法必须经过恶意代码的完全测试,要像写代码一样写测试,然后像API提供给外界约定文档一样使用测试。每当代码改变的时候就运行这些测试。不要担心代码覆盖率。重要的是外部约定。也可以考虑使用约定生命周期。
 
8.分层式成长
保持API突出重点,然后在顶部将新的API分层,以便于它们能随着时间的推移成长。可扩展性并不意味着无限期的成长。明确API的范围,并在范围内执行。
 
9.保持简单易用
最终的测试要看API的简单易用程度。你写的例子,能不能让你的代码看起来更简单?你是不是强迫用户说明他们不在乎的选项?有没有毫无价值的额外步骤?要注重约减少API的可视面积。
 
10.保持可移植性
不要让系统概念泄漏到API。整洁有目的地抽象:这个API可以运行在任何操作系统上。API必须能够隐藏实现,但要注意第4条规则,以及要使用自然抽象。
相关文章
  • API设计的十大原则
    这是最顶级的规则,只解决今天必须解决的问题,最小化需要完成的答案。解决明天的问题的诱惑力是巨大的,但是一定
  • PHP正则表达式:基础知识
    php中正则表达式是非常强大的,很多正则高级功能都有实现,那么下面就直接进行正则表达式介绍说明。
  • 提升PHP性能的15个要点
    对一个PHP程序员来说,除了完成业务逻辑外,PHP程序的性能也显得非常重要。在PHP程序开发中,性能的区别都是一些
  •  PHP五种缓存技术总结
    全页面静态化缓存也就是将页面全部生成html静态页面,用户访问时直接访问的静态页面,而不会去走php服务器解析
  • PHP变量的声明及其作用域
    PHP是一个弱类型的语言,所以在使用变量时,不用事先指定变量类型,在使用时根据上下文由系统解释器来判断变量的
  • 网站访问量和服务器带宽的选择
    通常我们说当一个网站的访问量比较大时,可能会占用网络带宽,造成网络的拥挤,因而对于一些大型网站来说,他们选择
  • php 三元运算符实例详细介绍
    三元运算符的功能与“if....else”流程语句一致,它在一行中书写,代码精练、执行效率高。在PHP程序中恰当地使
热门文章