程序接口设计的六大原则及注意事项

    每次在开故障总结会的时候,会遇到一种情况脏数据或接口交互异常所引起。接口设计的时候,尤其是对自我保护往往是容易被忽略的。

  遇到过两起故障: 

   1、第三方调用我们的接口,传入的数据不符合规则,但通过接口已入库,时间久了,不仅对业务有影响,数据量也增加好多,最后因数据量激增导致系统故障;

  2、因数据库里面有几亿的数据量,我方提供的接口,对方因业务需要,每天有几十万次的调用(且不讨论业务是否合理),我方未做自我保护,某天综合因素叠加导致系统故障;

接口的自我保护也是程序员编程的基本能力也是要求之一,希望所有的程序员在做接口设计的时候要考虑清楚,我要什么?别人怎么给?给多少?



下方的内容转自网络:乔胖胖

程序接口设计的六大原则

一.单一职责原则 Single Responsibility Principle, 简称SRP。

定义:There should never be more than one reason for a class to change.  应该有且仅有一个原因引起类的变更。

职责的划分?单一的定义和级别?

应该根据实际业务情况而定。关注变化点。

实际使用时,类很难做到职责单一,但是接口的职责应该尽量单一。

二.里氏替换原则 Liskov Substitution Principle, 简称LSP。

定义:Functions that use pointers or references to base classes must be able to use objects of derived classes without knowing it.

(所有引用基类的地方必须能透明地使用其子类的对象)  子类可以替换父类==原来要求是一个父类的对象 我现在给一个子类的对象 也是可以的。

里氏替换原则为良好的继承定义了一个规范:

1.子类必须完全实现父类的方法

2.子类可以有自己的个性(属性和方法)。

3.覆盖或实现父类的方法时输入参数可以被放大。

4.覆写或实现父类的方法时输出结果可以被缩小。

注:在类中调用其他类时务必要使用父类或接口,如果不能使用父类或接口,则说明类的设计已经违背了LSP原则。

三.依赖倒置原则 Dependence Inversion Principle, 简称DIP

定义:High level modules should not depend upon low level modules.Both should depend upon abstractions.Abstractions should not depend upon details.Details should depend upon abstractions.

翻译过来,包含三层含义:

1.高层模块不应该依赖低层模块,两者都应该依赖其抽象。

2.抽象不应该依赖细节。

3.细节应该依赖抽象。

精简的定义: 面向接口编程。

Test-Driven Development 测试驱动开发是依赖倒置原则的最好体现。

测试驱动开发要求先写测试类,测试通过才写实现类,这就要求你要先想接口定义。

依赖的三种写法:

1.构造函数传递依赖对象。

2.Setter方法传递依赖对象。

3.接口声明依赖对象。

最佳实践:

1.每个类尽量都有接口或抽象类,或者抽象类和接口两者都具备。

2.变量的表面类型尽量是接口或抽象类。

3.任何类都不应该从具体类派生。

4.尽量不要覆写基类的方法。

5.结合里氏替换原则使用。

四.接口隔离原则:接口–这里指用interface关键字定义的接口。

定义:

1.Clients should not be forced to depend upon interfaces that they don’t use.(客户端不应该依赖它不需要的接口)

2.The dependency of one class to anther one should depend on the smallest possible interface.(类间的依赖关系应该建立在最小的接口上)

概括:建立单一接口,不要建立臃肿庞大的接口。

通俗来讲:接口尽量细化,同时接口中的方法尽量少。

如何细化?细化到什么程序?

没有统一的标准,应根据业务合理细分,适合业务才是重点。

保证接口的纯结性:

1.接口要尽量小。

2.接口要高内聚。

3.定制服务。

4.接口的设计是有限度的。

最佳实践:

1.一个接口只服务于一个子模块或业务逻辑。

2.通过业务逻辑压缩接口中的public方法,接口时常去回顾,尽量让接口达到“满身筋骨肉”,而不是“肥嘟嘟”的一大堆方法。

3.已经被污染了的接口,尽量去修改,若变更的风险较大,则采用适配器模式进行转化处理。

4.了解环境,拒绝盲从。每个项目或产品都有特定的环境因素,不要盲从大师的设计,要根据业务逻辑进行最好的接口设计。

五.迪米特法则 Law of Demeter, LOD。又称 最少知识原则(Least Knowledge Principle , LKP)

通俗来讲:一个类应该对自己需要耦合或调用的类知道得最少,你(被耦合或调用的类)的内部是如何复杂都和我没有关系,那是你的事情,我就调用你提供的public方法,其他一概不关心。

低耦合要求:

1.只和朋友交流

朋友类:出现在成员变量、方法的输入输出参数中的类。方法体内部的类不属于朋友类。

2.朋友间也是有距离的

迪米特法则要求类“羞涩”一点,尽量不要对外公布太多的public方法和非静态的public变量,尽量内敛,多使用private、package-private、protected等访问权限。

3.是自己的就是自己的

如果一个方法放在本类中,既不增加类间关系,也对本类不产生负面影响,就放置在本类中。

4.谨慎使用Serializable


六.开闭原则

Software entities like classes, modules and functions should be open for extension but closed for modifications.(一个软件实体如类、模块和函数应该对扩展开放,对修改关闭)

软件实体包括以下几个部分:

1.项目和软件产品中按照一定的逻辑规则划分的模块。

2.抽象和类。

3.方法。

变化的三种类型:

1.逻辑变化

2.子模块变化

3.可见视图变化

接口设计需要考虑哪些方面

接口的命名。

请求参数。

支持的协议。

TPS、并发数、响应时长。

数据存储。DB选型、缓存选型。

是否需要依赖于第三方。

接口是否拆分。

接口是否需要幂等。

防刷。

接口限流、降级。

负载均衡器支持。

如何部署。

是否需要服务治理。

是否存在单点。

接口是否资源包、预加载还是内置。

是否需要本地缓存。

是否需要分布式缓存、缓存穿透怎么办。

是否需要白名单。

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,616评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 91,020评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 159,078评论 0 349
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 57,040评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,154评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,265评论 1 292
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,298评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 38,072评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,491评论 1 306
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,795评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,970评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,654评论 4 337
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,272评论 3 318
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,985评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,223评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,815评论 2 365
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,852评论 2 351

推荐阅读更多精彩内容