前言 本篇博文来自一次公司内部的前端分享,从多个方面讨论了在设计接口时遵循的原则,总共包含了七个大块。系卤煮自己总结的一些经验和教训。本篇博文同时也参考了其他一些文章,相关地址会在后面贴出来。很难做到详尽充实,如果有好的建议或者不对的地方,还望不吝赐教斧正。 一、接口的流畅性 好的接口是流畅 ...
背景 第一次听说 SPI 是阅读 软件框架设计的艺术 ,以后陆续在 Log Net 和Quartz.Net中发现了以这种形式组织代码的方式,本位给出为什么要区分 SPI 和 API 的一个思考过程。 从面向接口编程说起 我们在 调用方 和 实现方 之间引入了 接口 ,上图没有给出 接口 应该位于哪个 包 中,从纯粹的可能性上考虑,我们有三种选择: 接口 位于 调用方 所在的 包 中。 接口 位于 ...
2013-09-17 09:00 2 11694 推荐指数:
前言 本篇博文来自一次公司内部的前端分享,从多个方面讨论了在设计接口时遵循的原则,总共包含了七个大块。系卤煮自己总结的一些经验和教训。本篇博文同时也参考了其他一些文章,相关地址会在后面贴出来。很难做到详尽充实,如果有好的建议或者不对的地方,还望不吝赐教斧正。 一、接口的流畅性 好的接口是流畅 ...
RESTful API设计原则与规范 一、背景与基础概念 2 二、RESTful API应遵循的原则 3 1、协议(Protocol) 3 2、域名(ROOT URL) 3 3、版本(Versioning) 3 4、路径(Endpoints) 3 5、HTTP动词 ...
RESTful API的设计原则 Good API design is hard! An API represe ...
转载自一位大佬 英文原版 Principles of good RESTful API Design Good API design is hard! An API represents a contract between you and those who Consume your data. ...
在邮件列表和讨论区中有很多与REST和Web API相关的讨论,下面仅是我个人对这些问题的一些见解,并没有绝对的真理,InnoQ的首席顾问Oliver Wolf在GOTO Berlin大会上开始自己的演讲“Web API设计原则”时如是说。 不要考虑端点。SOAP有一个单独入口点的外观。相比之下 ...
...
开闭原则的定义 开闭原则的定义: 一个软件实体,如类、模块和函数应该对扩展开放,对修改关闭.即一个软件实体应该通过扩展来实现变化,而不是通过修改已有的代码来实现变化. 软件实体包括一下部分 项目或软件产品中按照一定的逻辑规则划分的模块 抽象和类 方法 注意: 开闭原则 ...
1、开闭原则(Open Close Principle) 对扩展开放,对修改关闭。在程序需要进行拓展的时候,不能去修改原有的代码,实现一个热插拔的效果。所以一句话概括就是:为了使程序的扩展性好,易于维护和升级。想要达到这样的效果,我们需要使用接口和抽象类,后面的具体设计中我们会提到这点 ...