前后端交互规范很重要
大家好,相信都遇到过前后端交互不规范导致的问题吧,接下来就讲讲我的。
工作室参加了一个web开发类的比赛,根据赛题需求开发一个成品系统,我主要负责后端,另一个队友负责前端。
由于我跟他都是第一次参与多人开发,根本没经验,最开始后端连接口文档依赖都没用,都是他问我页面对应接口,我在看我后端代码给他个示例来交互,这样一段时间后发现太麻烦了,就引入了 knife4j 依赖来生成接口文档,这次好多了。
但由于经验不足,又引发了另一个问题,那就是接口新增、修改时,有些参数前端是不需要传的,但由于实体类没有进行区分,用的都是同一个实体类,所以前端有些时候不清楚参数哪些不用传,其实这个问题鱼皮哥提到过,但我经常都是一个人开发,没当回事,现在意思到问题的严重性了hhh。
我不太清楚前端是否需要真正的懂业务,我那个队友不太懂业务上的设计,我有时跟他讲,他跟我说你直接告诉我传哪个接口的值,以至于接口传参一般都是我告诉他该接口传的参数是从哪个接口返回的那里传过去的,而一旦我有时没说清楚或以为他知道,他就会把参数传错。
上面的问题导致了什么问题呢?
由于在开发的过程中很少测试功能,在最后部署上线时候才把功能测试了一遍,导致全是bug,而且那天刚好是比赛提交前一天,真的是疯狂找bug,修bug,我记得那天才睡两小时,5点睡,7点起,而且在比赛提交前一小时还在改代码,最后在我的不懈努力下,总算修复的差不多了,在最后比赛提交截止半个小时搞定然后提交了作品。
到现在我终于明白了规范、测试系统功能的重要性,千万不要在最后上线的时候再去测试功能,也许这也就是为什么会有测试岗位了,bug能够及时发现并及时改正都好比在工期快要到的时候改一堆代码要强的多,那时候可能效率也不高,压力也大。
这就是我的经历和总结,最后我有几个问题,希望有经验的朋友能回答我一下
- 1.
前后端交互的规范一般在公司里是怎样制定的
- 2.
如果业务比较复杂,是选择后端写一个文档用来给前端阅读吗
- 3.
前端需要了解业务上的设计吗
- 4.
有关联页面的接口传参如何让前端更清晰的明白
