一统江湖的大前端(3) DOClever——你的postman有点low

《一统江湖的大前端》系列是自己的前端学习笔记,旨在介绍javascript在非网页开发领域的应用案例和发现各类好玩的js库,不定期更新。如果你对前端的理解还是写写页面绑绑事件,那你真的是有点OUT了,前端能做的事情已经太多了, 手机app开发 , 桌面应用开发 , 用于神经网络人工智能的库 , 页面游戏 , 数据可视化 , 甚至 嵌入式开发 ,什么火就搞什么,活脱脱一个蹭热点小能手。如果你也觉得前端的日常开发有些枯燥,不妨一起来看看前端的另一番模样。

Mock服务器 + Excel怎么了

如果你的开发进度还在被后端开发人员牵着鼻子走,请参考《一统江湖的大前端(2)—— Mock.js+Node.js如何与后端潇洒分手》,优化自己的开发工作流

有了Mock服务器和Excel的文档说明后,相信大家的沟通效率会比以前提升很多,但仍然被沟通占据着绝大部分开发时间,常常遇到的情况会有:

  • 没有注释信息,字段不宜对齐 Mock服务器返回的只有数据,没有注释信息,即便后端开发人员有心把查到的信息重组为你需要的字段,但仍有可能因为无法对号入座而作罢。
  • 接口数量增加后难以管理 简易的Mock服务器无法提供相应的接口文档,随着接口数量的增加,分分钟乱成一锅粥,总不能每次查个接口都是跑去翻Mock服务器的源代码然后看注释吧
  • 无测试支持 MockJs只生成模拟数据,并无任何对自动化测试的支持
  • 满怀热情写了API文档,But没人看 程序员大多没有Excel习惯,而且大家都很忙,忙到即便你提供了Mock接口以及相关的API说明,他们还是会再问你一遍关于接口的信息程序员习惯以自己熟悉的方式进行工作,而且一般默认这种效率最高
  • Excel版本的API文档方便交流,但不易更新 一对一联调时候还好,但如果项目组内协作人员较多时,麻烦就来了,每当你更新或是增加接口信息时,就要重新给所有相关人员发送一次新的Excel文件,很不方便。

DOClever——前端开发的接口管理工具

Java开发人员有Swagger,无严格保密性要求的可以尝试阿里的RAP,都是专业且强大的接口管理工具。当我们仅希望在内网中使用,或仅仅处于优化个人工作流的目的时,强烈推荐这块开源接口管理软件——DOCleverDOClever非常适合前端人员使用,VUE+express+mongodb编写,纯前端技术栈,能够实现团队管理接口管理文档管理自动化测试等功能,甚至可以根据接口返回数据自动生成接口文档的结构,方便智能。

无论你当前在做的项目是否有管理好相关的接口文档,作为开发人员,你都应该有自己的方式来管理好所有出自你手的接口

MockJs尚未失宠

  • 特殊场景 DOClever自带的Mock工具可以按参数类型生成虚拟数据,对于开发人员交流已经够用了,但如果前台需要多条模式相同的数据时,就需要用到上一篇博客中提到的MockJs来生成,(DOClever自带的Mock语法貌似尚未支持循环生成雷同数据,除了自己修改源代码外,如果还有其他更方便的实现方法也请不吝赐教~),DOClever中可以设置多台Mock服务器的url地址,常见的协作需求中,两套数据基本够用了,一套方便快捷,配合核对接口,另一套需要自定义开发,配合实现各种前端展示需求。

DOClever的安装

安装需要的东西真的比较多,尤其是对于非前端人员而言。

  • 1.安装nodejs 上一篇博客的附件中有nodejs V8.9的安装包
  • 2.安装mongodb mongodb的安装可以参考Windows环境下如何安装mongodb
  • 3.安装mongodb可视化管理工具(个人推荐robot3T)[可选]
  • 4.安装DOClever 由于是开源项目,直接在github上下载DOClever,使用方法主页有很详细的说明,按步骤来部署就可以了。 自己部署的图:

开始DOCLever

  • 可视化的管理API
    • 界面左侧树形图式管理所有相关API,方便查找
    • 可视化界面直接填写API相关信息
    • 参数化填写request请求体
    • 参数化编写响应数据,支持无限层次嵌套
  • 方便的Mock数据获取
    • 直接选择DOClever自带的mock服务器,可以方便地与协作人员沟通接口字段和结构
    • 选择自己搭建的Mock服务器,可以方便地获得更多模式相同的响应数据
  • 自动化接口测试
    • 简易的自动化测试语法
  • 自动化测试集计划任务
    • 定时跑任务自动化测试用例集

后记

别人开发的代码你可以不管,但出自你手的代码, 愿它们都是精品,易于查询,易于管理。

本文参与腾讯云自媒体分享计划,欢迎正在阅读的你也加入,一起分享。

发表于

我来说两句

0 条评论
登录 后参与评论

相关文章

来自专栏社区的朋友们

浅聊 API 网关

在微服务概念流行之前,API 网关的就已经诞生了,如银行、证劵等领域常见的前置机系统,解决访问认证、报文转换、访问统计等;而我今天的切入点是从 API-cent...

1.7K20
来自专栏wblearn

Web网站通知系统设计

写在前面: 通知系统是网站信息传播机制的重要的一部分,足够写一大章来说明。本文只梳理设计原则,后续相关内容会持续更新。 这里的通知包括但不限于公告、提醒或消息(...

1.5K20
来自专栏ThoughtWorks

组件测试:改建遗留系统的起点 | 洞见

在遗留系统中工作,无论是开发新功能,还是对旧功能进行修改,抑或是通过重构以期重拾其往日的雄风,都会面临大量的挑战。这些挑战主要来自于流失的业务知识、失传的技术和...

14730
来自专栏小黄人打代码

你想拥有自己的微信公众号吗?戳这里

19540
来自专栏java思维导图

微服务设计我们需要考虑哪些要点?

作者:刘超,毕业于上海交通大学,15年云计算领域研发及架构经验,先后在EMC,CCTV证券资讯频道,HP,华为,网易从事云计算和大数据架构工作。

16100
来自专栏杨建荣的学习笔记

防火墙开通的自动化尝试和感悟

对于一个从零到一的系统或者平台,你会有几十次几百次的调试,为的是能让系统/平台真正跑起来,用起来。我想这背后需要的坚持真是百般煎熬,一方面希望能够像建造...

13310
来自专栏Java后端技术栈

微服务设计我们需要考虑哪些要点?

作者:刘超,毕业于上海交通大学,15年云计算领域研发及架构经验,先后在EMC,CCTV证券资讯频道,HP,华为,网易从事云计算和大数据架构工作。

16120
来自专栏Java架构师历程

WebBuilder —— Web 开发平台

WebBuilder是一款跨平台、数据库和浏览器的可视化Web应用开发平台,使用了多项最新的技术,使Web应用的开发更快捷和简单。

1.4K40
来自专栏EAWorld

企业级API网关的设计

本文目录: 一、网关简介 二、网关的作用和价值 三、企业级API网关需要具备的条件 四、业界常用的API网关方案 五、如何设计一个好的企业级API网关产品 六、...

1.4K90
来自专栏杨建荣的学习笔记

shell的参数和脚本流程改进

今天痛下决心,把事务的工作一定要使用平台来做,时间短,任务紧,之前的运维开发是铺了一个面,每个面都做一些相关的事情,所以工作整体看都有进展,但是最后没有...

16430

扫码关注云+社区

领取腾讯云代金券