最新公告
  • 欢迎您光临起源地模板网,本站秉承服务宗旨 履行“站长”责任,销售只是起点 服务永无止境!立即加入钻石VIP
  • “双冷一怕怕”之接口对接经验要点

    正文概述 掘金(muchan92)   2021-01-11   629

    这几天看了看之前播的电视剧《最美逆行者》,听到里面的外号“双冷一怕怕”感觉蛮有意思的。正好也想写一篇关于接口对接经验的文章,内容也不多,突然脑海一闪,感觉要讲的内容和这个外号有些搭,所以就摘过来用一下,借助这个外号,也恰好能提高内容的记忆性和趣味性,比冷冷的罗列经验点要好一些。

    双冷

    这几天全国都开启速冻冰箱模式,大家都冷的瑟瑟发抖,北京这边的温度也要把人冷的裂开了,真心寒冷?。 不过冷一般容易令人思考理解一些东西,所以趁着这个温度的加持,来看一下“双冷”到底是个什么梗吧。这个冷笑话有点尴尬啊,没事,只要我不尴尬,尴尬的就是别人。

    冷静分析,谨慎设计

    在接到新项目,走完项目的流程,理解清楚项目需求后,基本就能确定出需要哪些数据结构和接口来了。

    接口和数据结构是不分家的。这里需要冷静分析,谨慎设计。
    既要保证良好的扩展性,也要保证安全。这里额外提到要注意接口的安全性,因为还是有不少开发人员仓促设计,而忽略了安全性。而如果前面的安全性没有设计好的话,后面维护的时候往往就比较困难,所以这里需要提前多注意安全性。

    扩展性这个就太重要了,也太容易让人理解了。
    接口和数据结构的设计,这会直接关系影响到整个项目的开发复杂度,所以要冷静分析,合理抽象,确保扩展性。扩展性好的接口和数据结构,能够更简单的容纳日后的更新需求,应该仅是增加新接口等小修小改,而不是返厂大修。没有谁希望看到,当后续的新需求提出后,发现需要大改原有的接口和数据结构,这会导致一个恐怖的行为:重构。

    所以要冷静分析,谨慎设计。

    这里有一个比较奇怪的实际现象,前端往往忽视这块的设计性,总认为这是后端应该注意的点。
    当然不是,前端也应该重视起来。
    因为一个好的前端系统,核心主要职责是:用数据来渲染显示,然后根据用户交互等,请求服务器获取新的数据结构,或重新直接本地更新数据结构,用于重新渲染。所有的目的,不要直接着眼于“显示”,而应该着眼于“数据结构”。因为显示就是 UI,就是个衣服,而“数据结构”才是穿衣服的人,总不能为了穿件新衣服而把人换了吧。

    所以要分清主次,数据结构永远是主。

    冷静沟通,宽容待人

    首先,我们所说的接口并不局限于前后端对接,也包含同系统内各个模块之间的对接等。

    和人打交道的事,摩擦往往是难免的,所以需要冷静沟通,宽容待人。

    每个人负责自己的部分时,大都会主观站在自己的位置上思考、设计,比较容易忽略与他人对接时遇到的突发情况。最好的方式当然是能够提前与需要对接的同事一起沟通确定对接方式,这能避免大部分问题。对于熟络的同事或接口比较简单的情况这种方式比较适用。
    对于时间进度不同步的情况,或不熟悉的同事,或接口复杂度较高需要由某方先梳理清楚的情况等,可能没有办法同时一起沟通来确认接口,只能被动等待最终的接口内容。当然这不提倡,但工作中难免会遇到这类情况,或遇到不好相处沟通对接的人,这就是生活~
    此时,更应该保持冷静的态度来沟通,要宽容对待对方,多换位思考,可能我们在对方的位置上也会设计出更适合自己而不太适合最终对接的接口。人嘛,难免出错~~ 多多理解,冷静沟通,达成一致就好了。

    一怕怕

    正如原电视剧里所说,这“一怕怕”才是最有趣的,接口这里也是比较有趣的,还记得电视剧里说的是什么吗?对的,怕麻烦。

    既要怕麻烦,又不要怕麻烦

    是的,就是这么有趣,啪啪打脸啊,这是什么鬼,这话是啥意思,整的有点懵啊~~

    首先,一定要保持一颗怕麻烦的心,凡事多思考一些,防微杜渐,这样才能避免或杜绝许多不必要的麻烦,只有不必要的麻烦才能称得上是真正的麻烦。

    这类麻烦一般有三个特点。第一,这是本来就可以提前避免的;第二,这是由于自己不走心,苟苟且且,自己惹的麻烦;第三,当技术债务堆积到一定程度,这个隐藏的麻烦会以难以想象的大麻烦的身份,携排山倒海之势冲击脆弱的心灵。

    所以不要怕接口或数据结构设计上的一些小麻烦,小麻烦都不算麻烦,提前把地基打好,整个系统才牢靠。何况接口部分就像城乡结合部,本来就具有混乱的天然属性,又像不同编制的两个军队的结合联防部分,脆弱不堪一击,所以此处需要牢牢稳固才行。

    具体到接口这里避免大麻烦的一个有效操作方案就是,永远不要轻信对方的数据结构

    因为他们在某一天可能会因为种种理由进行大的更改,如果我们在系统内某些地方直接调用了该接口,比如直接通过 http 的 url 调用了某一接口,那么一旦当对端的数据结构发生变化,那么系统接下来的内容都会崩溃。崩溃是正常现象,无需紧张,重新适配下就好了。但是,真正令人感到无比麻烦的是,旧的数据结构和新的数据结构有不少出入,结构字段变动了不少,这就导致要在所有需要用的该字段的地方都做新的处理,这实在是个大大麻烦。

    幸好的是,我们可以提前假定所有的接口数据结构都是会发生变动的,这样我们就有了容忍这种变动的准备。
    只需,不要直接在用到接口的地方直接调用该接口,而是简单封装,或统一管理接口,比如:不要直接 post domain/path/xxx,而是统一封装为 api.xxx(params)。这样的话,即使接口的入参或出参数据结构变了也没有关系,为什么呢?因为我们自己可以对其做次转换,将新的数据结构映射回旧的数据结构,这样一来我们就不需要重新深入系统修改所有依赖该数据的地方了,可以很好的将这个大麻烦解决掉。所以要统一管理接口,不要直接调用,因为那太原始了,不能做茹毛饮血的事情。

    为了避免大麻烦,而小小的麻烦统一下接口的管理是很有效的方案,因为对数据进行重新映射的成本很小。

    所以,这里真正的解读应该是:既要怕大麻烦,又不要怕小麻烦。

    总结

    双冷一怕怕,记住了么~

    题外话,《最美逆行者》是部不错的电视剧,值得一看。
    这篇也是完全躺着在手机上码的?


    起源地 » “双冷一怕怕”之接口对接经验要点

    常见问题FAQ

    免费下载或者VIP会员专享资源能否直接商用?
    本站所有资源版权均属于原作者所有,这里所提供资源均只能用于参考学习用,请勿直接商用。若由于商用引起版权纠纷,一切责任均由使用者承担。更多说明请参考 VIP介绍。
    提示下载完但解压或打开不了?
    最常见的情况是下载不完整: 可对比下载完压缩包的与网盘上的容量,若小于网盘提示的容量则是这个原因。这是浏览器下载的bug,建议用百度网盘软件或迅雷下载。若排除这种情况,可在对应资源底部留言,或 联络我们.。
    找不到素材资源介绍文章里的示例图片?
    对于PPT,KEY,Mockups,APP,网页模版等类型的素材,文章内用于介绍的图片通常并不包含在对应可供下载素材包内。这些相关商业图片需另外购买,且本站不负责(也没有办法)找到出处。 同样地一些字体文件也是这种情况,但部分素材会在素材包内有一份字体下载链接清单。
    模板不会安装或需要功能定制以及二次开发?
    请QQ联系我们

    发表评论

    还没有评论,快来抢沙发吧!

    如需帝国cms功能定制以及二次开发请联系我们

    联系作者

    请选择支付方式

    ×
    迅虎支付宝
    迅虎微信
    支付宝当面付
    余额支付
    ×
    微信扫码支付 0 元