1 Star 0 Fork 191

raowb / v-mock

forked from vtDev / v-mock 
加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
贡献代码
同步代码
取消
提示: 由于 Git 不支持空文件夾,创建文件夹后会生成空的 .keep 文件
Loading...
README
MIT

-VMock

V-Mock

简单,轻量级,秒部署的接口模拟系统。

V-Mock是什么

V-Mock是一个小巧的接口响应模拟系统,安装完成后,录入你要模拟的接口URL,及该URL返回的JSON,XML或者其他格式的返回数据,即可开始调用。

功能

  • 支持任何请求类型,包括Path传参请求。
  • 支持自定义的响应Header,http status code,以及返回体。(但是不建议乱写http码,比如有的浏览器接收到返回状态是789,可能请求就挂了)
  • 提供每次调用成功的详细【请求体详细】以及【响应体详细】的日志,请求头..参数..Header..Cookies都能找到。
  • 支持创建多种返回格式,一键切换。
  • Sqlite嵌入式数据库,用户不用关心数据库事项,可以当作没有数据库。

ps: 暂时不支持根据请求参数的逻辑切换返回格式,仅可以在后台一键切换返回体,但这样的好处是方便开发/测试人员测试。

什么场景你可能会用V-Mock?

  • 前后端对接,后端暂未开发完成。
  • 第三方对接,但对方无法提供测试环境。
  • 要求Mock功能对代码“0”污染
  • 公司数据安全严格/Mock数据无法托管到第三方/内网开发等情况。
  • 觉得同类高端软件功能太多用不上/不易部署等😀

如何安装

如果只是使用,我们只需要JRE即可,无需任何其他软件。
不用clone源码!!!直接到Releases页面(访问慢可以用码云的),下载最新版本的jar包

只需一行命令即可使用

java -jar v-mock.jar

默认80端口 可以追加 --server.port=xxx 自己指定

🌟需要注意! sqlite的数据库临时文件默认是放在java.io.tmpdir下,暂无其他变量控制,默认是系统的临时文件目录,
如果你的设备会有清理临时文件的操作,可以在-jar之前插入-Djava.io.tmpdir=xxxxx修改本项目的tmpdir路径,以免造成数据丢失。
新版默认修改了java.io.tmpdir路径为当前jar所在位置, 以防数据文件丢失。

例如, 8098端口启动:

java -jar v-mock.jar --server.port=8089

推荐保存为sh或bat脚本,方便下次使用。

如何使用

安装完成后,根据自己的ip以及指定的端口,访问V-Mock后台界面。 使用管理员账号:vmock/vmock123 登录系统

登录成功后,即可在【接口一览】模块,配置需要Mock的URL了。

注意

所有被Mock的URL所属Context Path默认是 /vmock 则如果配置了/v1/test,请求是由http(s)://ip:prot/vmock/v1/test接收 也就是说如果调用者的系统,是将根路径写在配置文件中的话,需要把/vmock加上即可

如果配置了矛盾的URL,那么Path优先级是最低的。如: 配置了/v1/test/{path}又配置了/v1/test/12 那么访问/vmock/v1/test/12进的是1/test/12的配置,/vmock/v1/test/13会进入/v1/test/{path}的配置

多用户

管理员也可以修改系统参数中的【邀请码】,则普通用户即可通过邀请码自行注册系统。

权限

权限设计非常简洁:

  • 管理员:能多看见【系统参数】【用户管理】两个模块。
  • 普通用户:可以使用【接口一览】和【接口日志】模块。
  • 未登录:可以调用/vmock下,系统中配置好的Mock接口。

部分截图展示

登录 注册

登录 注册
接口一览 返回体一览
接口一览 返回体一览
增加返回体 Postman调用结果
增加返回体 Postman调用结果
日志一览 修改邀请码
日志一览 修改邀请码
请求详细 响应详细
请求详细 响应详细

作者

MIT License Copyright (c) 2019 vt Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

简介

轻量级 易部署 接口Mock系统 展开 收起
Java
MIT
取消

发行版

暂无发行版

贡献者

全部

近期动态

加载更多
不能加载更多了
Java
1
https://gitee.com/raowenbiao/v-mock.git
git@gitee.com:raowenbiao/v-mock.git
raowenbiao
v-mock
v-mock
master

搜索帮助

14c37bed 8189591 565d56ea 8189591