Web开发

首页 » 常识 » 常识 » 用上这个神器,让你的开发爽上天
TUhjnbcbe - 2022/6/19 15:34:00
静态的Swagger们跟不上频繁变更的代码

“为什么改了这个没告诉我”,“实际功能和文档上说的不一样啊”。这些话大家做开发的想必耳朵都听出老茧了。真不是故意的,有时候任务比较急,就先改了代码,想着以后再同步文档,然后就给忘了。项目更新又全靠社交软件通知,人一多难免有一两个没及时沟通到的。确实给合作的小伙伴带来麻烦,但说实话开发也挺委屈的。

这些问题产生的主要原因是,当前大部分研发团队的工作流程是这样的:

旧协作模式

这种模式带来的问题是:

1.Swagger,postman,MockJS只能完成软件研发流程中某个环节的功能,造成完成接口设计,文档编写,调试,测试验证等工作需要使用好几个工具;

2.更麻烦的是这些工具数据格式不互通,无法互相导入,造成用Swagger定义和编写完成接口后,在Postman,MockJS,Jmeter等工具还要再去手动填写一遍才能开始工作,增加了无意义的工作量。

3.沟通成本总是被忽略不计,但实际上不仅占据了很大时间,各种沟通不及时、沟通不到位还非常让人心累。

4.老板的需求来得急,老板的需求变得快,各种代码修改和变更难以及时通知和同步到团队成员手中。

抱怨当然*治正确,但有啥用,该加的班还是要加。那么有什么办法可以解决这个问题吗?

有的。

换个工具。

低成本做长期主义的事情

我为大家提供的解决方案是一款国内的生产力工具--Apifox。

作为一款研发全流程,接口全周期的生产力工具,这款软件真正完成了数据流的打通,在一个软件上就能实现接口设计--接口文档--接口调试--接口修改--接口mock--接口测试--接口自动化--接口迭代的工作流闭环;

后端,前端,测试各个角色既能各取所需,又能协同合作。

Apifox上的协作流程是这样的:

后端在Apifox可视化接口设计界面上定义好项目各个接口及对应参数同时编写接口文档说明

前后端一起评审,修改完善接口并在同一界面顺手更新接口文档

后端使用接口调试功能调试接口

前端使用零配置高仿真mock功能对前端页面进行调试,无需手写mock规则

后端使用代码生成功能直接生成接口代码

测试在接口管理页面一键生成接口参数测试用例,并依据业务场景生成自动化测试用例,一键运行接口用例并生成接口测试报告并分享给相关人员。

前后端都开发完,前端从Mock数据切换到正式数据,进行联调,由于使用同一个接口数据源,且遵循了接口规范,联调顺利

由于bug修复或需求变更,接口发生了变化,后端修改提交后,前端和测试实时同步到了修改后的数据

项目经理通过权限设置给研发,产品,测试,外部合作人员分配编辑,只读等各种操作权限,维护了项目安全

项目经理通过各个接口的状态开发中,测试中,已发布来跟进项目的进度情况,把控项目风险。

Apifox核心功能和界面是这样的:接口设计接口调试智能mock接口自动化

36氪报道过,Apifox在Pre-A轮融资就得到了万元的融资。资本市场如此看好这个产品的发展潜力,是因为在经济增速变缓的现阶段,

对企业来说,它能通过提高整体的合作效率来为企业节约成本;

对研发人员来说,可以减少无意义的工作量和繁杂耗时的沟通成本,将时间花在能提升自身竞争力的地方。

ApifoxSwagger+Postman+mockJS+Jmeter,它在传统软件的基础上做了不少操作优化和团队协同提效的功能。

Apifox做的增速提效优化

1.接口设计:从代码生成界面到可视化接口设计界面

Apifox接口文档遵循OpenApi3.0(原Swagger)、JSONSchema规范,可生成在线文档;零学习成本即可编写出符合RESTful风格的接口文档,新人上手快;所见即所得,不易出错。

Swagger通过写代码生成接口页面Apifox可视化接口设计页面

2.文档维护:从接口与文档分离到接口与文档合并

当你接手旧项目时,发现接口是上周的,接口文档是商周的,上手新项目全靠老司机口口相传,内心大概是崩溃的吧。

接口与文档分离常常导致维护困难。Apifox的接口设计界面提供了Markdown格式的文档说明区,修改完接口就如同

1
查看完整版本: 用上这个神器,让你的开发爽上天