你们公司是如何做接口联调的?(公司项目里如何进行前后端接口联调)

最近Jack进入一家新的公司,正好公司项目采用的是前后端分离架构,技术栈是Jack非常熟悉的vue全家桶,后端用的是Java语言。

在前后端开发人员碰面之后,协商确定好了前端需要的数据接口(扯那么多,其实也就是关于json数据的字段的定义),然后前后端程序猿就嗨皮地并线开发去了。

前后端联调前夕

Jack他们这家公司做本地旅游项目的,安排到他手上的活儿是该旅游项目的webapp工程。

项目动工开始,一切都得从头来做。在公司没日没夜的开发了一天之后,Jack在没有借助vue-cli官方提供的脚手架工具下,徒手从零开始,搭建了一套基于公司特定要求的vue项目的工程架构目录。

前端项目环境搭建好之后,就正式进入了项目首页的业务编码工作。Jack又没日没夜的敲了一天代码之后,首页header区域、轮播图以及导航图标的页面布局和逻辑开发都实现了,此时他想调用后端数据测试下流程,但是后端程序猿还没有将该数据的接口开发出来,没办法,我的朋友Jack此时只能在本地模拟点假数据,逼格高点的说法叫mock数据。

捣鼓半天,首页的mock数据终于弄好了,如下图所示:

但是现在有一个问题让Jack很困惑,他的axios写的url路径是与后端程序猿商量好的绝对路径(域名+请求路径+请求参数),因为这是以后真正的请求路径,所以我朋友Jack又不想先写本地相对路径,后期再来修改,万一后端程序猿开发的慢了,鬼知道到时候有多少接口需要修改,所以他就迷茫不知所措了。

其实,仔细看看,这就是前后端分离中的mock数据和接口联调的问题。要想弄懂其中缘由,下面让我们分几点来聊聊。

什么是前后端接口联调?

之前开发写代码的时候,所有的ajax数据都不是后端返回的真实数据,而是我们自己通过接口mock模拟的假数据,当前端的代码编写完毕,后端的接口也已经写好之后,我们就需要把mock数据干掉,尝试使用后端提供的数据,进行前后端的一个调试,这个过程我们就把它称之为前后端的接口联调。

为什么要联调?

本地的mock数据是jack自己写的,肯定符合前端需求,但是后端接口首先需要测试通不通,还需要测试数据格式对不对,还有后端有没有填写足够的数据,比如写列表页,前端想分页,如果后端就写了两条测试数据,你咋整?

所以,Jack需要根据后端对接口的调整,不断地来回切换url,这样岂不是还在受后端的影响,还谈什么毛线的前后端分离,名存实亡嘛!

如何实现前后端接口联调?

首先,我们已经知道,目前的前后端分离的架构应用分为两种情况:

前后端完全分离,前后端分别拥有自己的域名和服务器。

前后端开发分离,但是部署时是一个域名和一台服务器。

虽然架构可以采用前后端分离,但是部署有可能就不一样了,这和项目的大小,公司的情况等等都有关系了,一个百八十人用的小系统,还得两台服务器两个域名,你不觉着浪费吗?

两种不同的部署情况直接导致了前期在设计联调方案的时候就不同了。

如果你们公司的项目在部署时是两台服务器对应两个域名,恭喜你,这是最nice的方案,也是联调最舒服的方式。

但是,我朋友Jack呆的这家公司是一家刚起步的小公司,肯定是怎么节省成本怎么来,问过后端,才知道他们公司是属于第二种情况,也就是开发时前后端分离,部署时是一个域名和一台服务器。知道这个之后,他就明白接下来该怎么操作了。

Jack之前在项目根目录static文件夹下新建了一个mock文件夹,里面写了一些json文件,当我们做联调的时候,这些mock数据就没用了,我们要把mock数据切换成后端提供给我们的真实的数据。

当我的朋友Jack把static文件夹下的mock数据删除之后,在运行项目,发现报错了,浏览器告诉他,你访问的mock下面的index.json文件找不到404。

我们平时本地前端开发环境dev地址大多是 localhost:8080,而后台服务器的访问地址就有很多种情况了,比如 后端程序猿本地IP(127.0.0.1:8889),或者外网域名,当前端与后台进行数据交互时,自然就出现跨域问题(后台服务没做处理情况下)。axios不支持jsonp, 所以我们就要使用http-proxy-middleware中间件做代理。

现在通过在前端修改 vue-cli 的配置可解决: vue-cli中的 config/index.js 下配置 dev选项的 {proxyTable}:

proxyTable: {

'/api': {

target: '127.0.0.1:8889', // 真实请求的地址

changeOrigin: true, // 是否跨域

}

}

如果你想在公司的vue项目中实现前后端联调,不需要再使用类似于fiddler charles的抓包代理工具了,你只需要使用proxyTable这个配置项,把你需要请求的后端的服务器地址写在target值里就OK了。

解决完跨域问题后,接下来Jack该想想怎么在一台服务器一个域名下进行联调的问题了。比较常见的做法是前端在本地修改,本地查看,测试好了以后上传到服务器,看看线上环境可不可以,OK的话一切都好;不行就本地接着改,然后在上传。

联调完之后,如何将前端打包的项目文件发给后端,这里也需要注意两点:

(1)css、js和图片等静态文件

这时候的静态文件在开发阶段不需要任何考虑,按照你喜欢的相对路径或者相对于项目的根路径的形式写就行了,因为早晚还得交给后端。但是,需要注意:

如果你采用 相对项目根路径的书写方式来写你的静态文件路径 时,一定要先和后端商量好,将来项目部署的时候他会把你的前端整个项目放在哪里?如果不是根目录下,你就挂了。比如:你的reset.css的路径是 /exports/styles/common/reset.css ,后端把你前端项目放在了根目录下的 frontEnd 文件夹下, reset.css 文件就报404了。

如果后端采用的java,你需要特别注意的是, tomcat的根目录 并不是 webapps 文件,而后端项目默认是部署在 webapps/ROOT 文件下的,所以你如果使用了相对项目根路径的书写方式来写你的静态文件路径时,对不起又是404了。

(2)ajax后端数据

因为现在唯一的一台服务器还是在后端程序猿那里,所以此时你还是可以写绝对路径(域名+请求路径),利用hosts文件来改变域名映射实现联调。

编者有话说

看这篇文章的朋友,不管你是在大公司还是在小公司,都需要知道,并不是说你将dist文件打包发给后端就完事了,就不需要了解leader后面操作的点击部署、合并分支的事儿了。

基础命令、拉取分支、构建编译包、copy生产包到服务器、备份资料、启动脚本、灰度发布、等等流程其实都是很有必要了解的。

要不然最开始没有这些基础设施、基础组件,谁来搭建+运行呢,毕竟还是需要第一批吃螃蟹的人.

即使大公司,也有小团队的,有的小团队不一定遵循大公司那一套自动化部署教程,也有自己玩自己的轮子+工具。

就算是大公司, 如果基础架构组的工具做好了,但是没有总监以上的大佬面向公司推广, 这些基础设施不一定能面向公司内部使用。

基础设施、基础组件能够面向公司内部大量使用,离不开公司高层领导的支撑、当然也有基础设施团队的辛苦开发、还需要有使用基础组件的机遇和业务场景。

总结:当你处在前后端分离的大浪潮下,做前端的要将眼光放在整个项目上,统筹全局,不要偏安一隅,待在前端的小角落里独自玩耍。


前后端一起工作的时候,最常见的一个情况就是后端定义接口,前端调用接口。

但是在前端调用接口的时候,经常容易出现调不通的显现,现在总结一下经常出现的错误:

比如后端在swagger上定义了一个接口

每一列有自己的含义;

1、相关页面的所有请求的汇总

2、get方法还是post方法

3、访问的地址是什么

4、扩展的描述,包括这是做什么的

打开第一个采购红冲调整:

1、返回码,如果正常调用后端内容,返回200 OK

2、返回的一个实例。如果点Model,可以参看每个参数的具体数据类型。

3、前端给后端传递参数。

4、参数的描述

5、传递哪些是必须的,类型是application/json。点击一下这个小窗口,可以自动填充模拟数据,然后点击8,模拟前后端联调。非常方便的啦。

6、返回其他字段

7、给后端传递数据的一个实例,如果点击model,可以看每个字段的数据类型。

8、Try it out 可以模拟前后端联调,试一下。

前后端联调可能出现的问题:

1、get,post 方法使用错误。

2、地址使用错误

3、传给后端的参数缺少某个必填选项

4、传给后端的某个参数字段拼写错误

5、传给后端的某个参数字段赋值的格式不对。尤其是时间戳经常出现问题。

6、传递后端参数出现对象中包含对象的时候,注意结构是不是完全对应。要求完全对应。

7、有时候前端偷懒时候,直接把state传递给后端,这时候会有非常多的参数。前后端能正常工作,但是为了让传递参数更简洁,常常前端删掉某些不必要的参数。这时候尤其注意,直接delete this.state.XYZ ,可能会让前端不能正常工作,因为之前的某个地方使用了XYZ参数做逻辑运算。这时候可以通过复制state的参数给变量parameter,然后删掉parameter中的变量XYZ,再传递parameter给后端。另外注意复制的时候,不能是地址复制,可以通过parameter=[...state]复制。


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

推荐阅读更多精彩内容

  • 最近我的朋友Jack进入一家新的公司,正好公司项目采用的是前后端分离架构,技术栈是Jack非常熟悉的vue全家桶,...
    Java大生阅读 20,804评论 0 23
  • 问题: 小张同学的项目采用的是前后端分离架构,现在前后端程序猿已经碰过面,协商好了一些前端需要的数据接口,于是前后...
    xinyuans阅读 6,602评论 1 10
  • 最近忙着赶项目,写写开发中的一些事儿吧。这两天和两个后端妹子进行后端联调,给了 10 个接口 8 个接口都是报错的...
    VioletJack阅读 3,903评论 0 1
  • 生活是一个递进的过程,人应该学着从曾经阴霾的时光中汲取营养,来为自己的成长所用,如此才能一点点地变得更好,把路走得...
    静女其姝Y阅读 297评论 1 2
  • 三月春天又如期而至。在日本的华人小伙伴儿纷纷期待起晴暖好天气和美丽樱花季。 但是有一种病名叫花粉症,也跟着春姑娘的...
    东京侯侯阅读 357评论 0 1