Skip to content

Mockserver is a mock data tools and switch between mock data and real data,【一个用于前后分离时模拟数据的web系统,并可在直实数据与实际数据中自由切换】

License

flftfqwxf/mockserver

Repository files navigation

基于thinkjs开发的WEB MOCK-SERVER(数据模拟)工具 ,其主要目的是在前后端分离开发时,用于模拟后端返回数据

English

功能说明

  • 支持可视化编辑JSON接口数据及接口文档

  • 支持GET、POST、PUT、DELETE,SEARCH,等所有请求类型

  • 支持类似【postman】 接口测试功能

  • 支持RESTful格式路径:如: /a/:user/:id

  • 支持指定返回状态码,默认200

  • 支持延时返回数据

  • 支持mockjs

  • 支持跨域调用项目接口

  • 支持 swagger

  • 支持模拟接口与真实接口切换,在切换到真实接口时,能够接收POST,GET,COOKIE等在http header请求的参数

  • 支持中英文切换

  • 支持客户端 'text/plain' 类型的 POST 提交(postman中 Body 选择 raw

demo只作演示作用,并会定期清除数据

欢迎star,并提出改进意见

支持作者

微信

淘宝

Install dependencies

npm install

初始化数据库

  1. 使用系统自带初始化数据库功能(推荐)
  2. 手动导入数据库文件,并修改数据库配置
需要安装mysql[5.7.14], 并导入最新的mockserver.sql 文件
修改/src/common/config/db.js中的数据库配置

Config

/src/common/config/config.js

Start server

npm start
#Server running at http://127.0.0.1:8033/

Examples

假设:

  • mock-server启动地址: http://127.0.0.1:8033
  • 已创建一个项目,项目 id为:8a15fbb94471050bb46f
  • 已创建一个接口 : /api/demo

跨域:

以 jQuery AJAX 为例:

    $.getJSON('http://127.0.0.1:8033/8a15fbb94471050bb46f/api/demo').done(function(){
    
    
    }).fail(function(){
    
    })

同域,但API接口与nginx server_name不在同一域名下:

假设:

    server {
            listen 80;
            server_name  www.site.com;
            root your/project/path;
            gzip_static on;
             # 将 /api下所有请求代理到 mock-server
             location ^~ /api {
            
                        rewrite ^/api/(.*) '/8a15fbb94471050bb46f/api/$1' break;
                        proxy_set_header Host $host;
                        proxy_set_header X-Real-IP $remote_addr;
                        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                        proxy_set_header X-Forwarded-Proto $scheme;
                        proxy_pass http://127.0.0.1:8033/;
                        break;
                    }
            location  / {
                proxy_pass http://127.0.0.1:8034;
            }
        
        }

同域且API接口与项目在同一个域名下:

假设:

nginx config:

        server {
            listen 80;
            server_name  www.site.com;
            root your/project/path;
            gzip_static on;
             
            location ^~ /api {
                set $is_proxy 0;
                # 如果是从mock-server代理到的请求,则会含有$http_is_mock_server_proxy参数
                if ($http_is_mock_server_proxy){
                    # $http_is_mock_server_proxy is mock-server writed header
                    set $is_proxy $http_is_mock_server_proxy;
        
                }
                # 如果不是从mock-server代理过来的请求
                # 则将 /api目录下所有请求代理到 mock-server服务下
                if ($is_proxy = 0 ){
                    rewrite ^/api/(.*) '/8a15fbb94471050bb46f/api/$1' break;
                    proxy_set_header Host $host;
                    proxy_set_header X-Real-IP $remote_addr;
                    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
                    proxy_set_header X-Forwarded-Proto $scheme;
                    proxy_pass http://127.0.0.1:8033/;
                    break;
                }
        
                #当二次代理开启并且 二次代理域名与 [server_name]一样时,
                #请求会先代理到mock-server,然后再代理到nginx,出现循环代理,因此
                #在此处判断如果已经是从mock-server代理过来的请求则不再次代理
                if ($is_proxy = 1 ){
                    add_header http_is_mock_server_proxy "$is_proxy";
                    proxy_pass http://127.0.0.1:8034;
                    break;
        
                }
            }
            location  / {
                proxy_pass http://127.0.0.1:8034;
            }
        
        }

在[your.site.com]下,就可以同域调用接口:

    $.getJSON('/api/demo').done(function(){
    
    
    }).fail(function(){
    
    })

更新日志:

2017-7-16

修改项目ID为随机hash,并以此ID为接口路径的前缀,并删除原设置API前缀功能

优化代码,及提供POST,PUT,DELETE等method type的接口预览功能

2017-4-25

添加国际化,中英文切换

修改jsoneditor 中文输入BUG


2017-4-11 

有更新,需要重新导入数据库文件

支持跨域调用项目接口

添加header 代理白名单和黑名单

允许自定义项目接口前缀

优化交互体验及BUG

 添加返回状态码
 
 添加延迟返回数据
 
 优化部分验证

About

Mockserver is a mock data tools and switch between mock data and real data,【一个用于前后分离时模拟数据的web系统,并可在直实数据与实际数据中自由切换】

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published