DOClever是一个商业化开源产品,完全免费。无论你是前端工程师,还是后端工程师,接口永远都是两者交互的桥梁,所以DOClever专为中小型团队量身打造,旨在解决接口的管理,测试与数据生成,实现真正的一体化解决方案。
功能1.团队协作,可以对不同的成员分配权限,有两种权限,管理员:可以增删改查项目和接口信息。观察者:可以查看,测试,mock接口数据,但是不能修改接口和项目的信息。
2.编写接口文档,摒弃了传统的纯文本编写方式,采用可视化编写,随意拖拽,可以添加任意层次信息,并且实时预览文档编写结果。
3.对接口进行测试,对于外网测试,没有跨域,后台采用的是proxy代理,对于内网,需要在本地安装node环境,然后下载系统内提示的net.js文档,在本地用node运行即可。net.js就是一个http,https的透明代理。
4.自动生成接口,很多时候,我们的后端开发人员都是先将接口开发好,再去写接口文档的,或者是接口有比较大的改动,接口文档也要改动很多。对于这种情况,可以在测试接口后对接口的文档信息进行一键自动生成,接口的所有入参,出参,http头都会自动生成到文档,我们要做的就是简单的修修改改就可以啦
5.对数据进行无缝mock,在大部分情况下,前端的开发人员都是要等待后端的开发者将接口开发调试好才能进行下一步开发,这样会耗费大量的时间精力,如果要本地生成数据那么成本也会比较高,所以DOClever有独特的无缝mock技术,只需要在本地用node运行net.js,加上mockserver地址(每个项目都会自动生成自己的mockServer地址)和你需要请求的真实地址,当您的接口文档的状态为开发完成的时候,net.js不会去请求mockserver地址而去请求真实地址.
DOClever开源本次开源的是DOClever的内网版本,可以直接部署到内网中,和线上版本在功能上是完全一样的,区别在于:
1.线上的系统用了前端和后端两套工程,并且用nginx做了负载均衡,redis做缓存,而内网版本合并为一个工程,直接用node做静态服务器,取消了缓存,这样对于很多中小型团队来说很轻便而且也够用了。
2.线上系统在安全性方面做了不少加固处理,而内网版本默认内网是安全的,也为了提高node作为服务器的效率,取消了很多加固处理,如果用户有需要可以自行添加。
如何部署1.首先本地要安装node环境,推荐6.10.0版本(下载页面)
2.安装mongodb(下载页面),可使用robomongo来作为mongodb的客户端工具(下载页面),启动mongodb后(如何启动),用robomongo来连接,新建一个database作为DOClever的数据库(名称随意)
3.将DOClever的源码down到本地,进入根目录,修改config.json
{"db":"mongodb://localhost:27017/DOClever", //这里为你的mongodb服务器的地址和库的名称"filePath":"/Users/Shared/DOClever", //这里作为DOClever文件上传的路径"imgPath":"/Users/Shared/DOClever/img", //这里是DOClever图片上传的路径(是DOClever文件上传的路径的直接子目录) "tempPath":"/Users/Shared/DOClever/temp", //这里DOClever临时文件上传的路径(是DOClever文件上传的路径的直接子目录) "port":10000, //DOClever启动的端口号"version":"1.0.0" //DOClever的版本号(无需修改)}4.在命令行下运行nodeDOClever的根目录/Server/bin/www即可启动DOClever(如果是windows环境下,请修改目录分隔符),在浏览器里输入localhost:DOClever启动的端口号,出现首页表示部署成功。
评论