前后端分离 接口管理神器——Rap本地搭建

Posted 2020-08-06 云の旋律

 我这里要用做mockserver的就是rap了，rap结合了团队管理，项目管理，文档编写、Mock.js、可视化、接口过渡、文档历史版本（赞）、mock插件（线上线下切换就只需要注释一句代码就OK），支持本地部署。

由于官网讲解的太模糊了 ，而且图也不配一个 让人觉得好寒蝉啊！

展示地址：http://rap.taobao.org/org/index.do 感觉如果担心数据接口安全问题，那么就需要走下一步了，搭建属于自己团队的服务器！

参考搭建地址1：http://blog.csdn.net/xinxin19881112/article/details/52279778 （这个讲解的比较全了 虽然有几处是不完善的，待我给他补上）

参考搭建地址2：http://www.cnblogs.com/dothin/p/5361883.html （这个讲解的比较全了 虽然有几处是不完善的，待我给他补上）

感觉是不是天下文章一大抄的感觉，不过也不影响我们的进程。

我把用到的安装包统一放到百度云盘中，文件名称：rap搭建所需要的工具包

接下来该我补充上面文章中所欠缺说明的东西！

我先秀一下自己的本地成果先：

这是需要本地启动的三个服务；

 

本地访问的界面效果

自己小测试了一下下

以下说明全部补充的是：参考搭建地址1

1。当链接好本地数据库后需要执行一段脚本，创建本地的数据库！

CREATE DATABASE IF NOT EXISTS rap_db
  DEFAULT CHARSET utf8
  COLLATE utf8_general_ci;

USE rap_db;


/**************************************************
 *                                                *
 *          account module                        *
 *                                                *
 **************************************************/


/**
 * user table
 */
CREATE TABLE tb_user
(
  id                      INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  account                 VARCHAR(32)            NOT NULL
  COMMENT \'账户名 account name\',
  password                VARCHAR(128)           NOT NULL
  COMMENT \'密码 password\',
  name                    VARCHAR(256)           NOT NULL
  COMMENT \'名字/昵称 name/nickname\',
  email                   VARCHAR(256)           NOT NULL
  COMMENT \'email\',
  create_date             TIMESTAMP              NOT NULL
  COMMENT \'创建日期 create date\'
    DEFAULT now(),
  is_locked_out           INT(1)                 NOT NULL
  COMMENT \'用户是否锁定 is the user locked out\'
    DEFAULT 0,
  is_hint_enabled         INT(1)                 NOT NULL
  COMMENT \'是否开启新手引导 is user hint enabled\'
    DEFAULT 1,
  last_login_date         DATETIME               NOT NULL
  COMMENT \'最近登录 last login date\',
  incorrect_login_attempt INT(10)                NOT NULL
  COMMENT \'错误登录次数，登录成功后会重置为0 count of incorrect login attempts, will be set to 0 after any succesful login\'
    DEFAULT 0,
  realname                VARCHAR(128)           NOT NULL
  COMMENT \'真实姓名\'
    DEFAULT \'\',
  emp_id                  VARCHAR(45)            NULL
  COMMENT \'工号，可选\',
  mock_num                INT(10)                NOT NULL
  COMMENT \'mock次数，用于记录该用户所创建的接口被调用的mock次数。 mock num, used for record mock API invokation count\'
    DEFAULT 0
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * role table
 * roles instruction:
 *     user  - every registered shuold have this role
 *       rd  - research and development engineering
 *       qa  - quality engineering
 *       pm  - project manager
 *       op  - operation manager
 *    admin  - administrator
 *      god  - super admin
 */
CREATE TABLE tb_role
(
  id   INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  name VARCHAR(16)            NOT NULL
  COMMENT \'角色名称 role name\'
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * user role table
 */
CREATE TABLE tb_role_and_user
(
  user_id INT(10) NOT NULL,
  role_id INT(10) NOT NULL,

  PRIMARY KEY (user_id, role_id),
  FOREIGN KEY (user_id) REFERENCES tb_user (id),
  FOREIGN KEY (role_id) REFERENCES tb_role (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;


/**************************************************
 *                                                *
 *          project module                        *
 *                                                *
 **************************************************/



/**
 * parameter table
 */
CREATE TABLE tb_parameter
(
  id         INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  name       VARCHAR(256)           NULL
  COMMENT \'参数含义 parameter name\',
  identifier VARCHAR(256)           NULL
  COMMENT \'变量名/参数标识符 parameter identifier\',
  data_type  VARCHAR(32)            NULL
  COMMENT \'数据类型 data type\',
  remark     TEXT                   NULL
  COMMENT \'备注/mock数据等 remark/mock data\',
  expression VARCHAR(128)           NULL
  COMMENT \'备用字段：表达式 backup column:expression\',
  mock_data  TEXT                   NULL
  COMMENT \'备用字段:mock数据 backup column:mock data\'
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * project table
 * workspace_mode 1-vss(default) 2-svn
 * stage 1-design 2-developing 3-debug
 */
CREATE TABLE tb_project
(
  id             INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  `version`      VARCHAR(128)           NOT NULL
  COMMENT \'版本号 version no.\'
    DEFAULT \'0.0.0.1\',
  name           VARCHAR(128)           NOT NULL
  COMMENT \'项目名称 project name\',
  create_date    TIMESTAMP              NOT NULL
  COMMENT \'创建日期 create date\'
    DEFAULT now(),
  user_id        INT(10)                NOT NULL
  COMMENT \'创建人ID, project author id\',
  introduction   TEXT                   NULL
  COMMENT \'项目描述 project introduction\',
  workspace_mode INT(10)                NOT NULL
  COMMENT \'工作区提交模式(类VSS or SVN)，暂时弃用了。 Workspace submit mode, deprecated.\'
    DEFAULT 1,
  stage          INT(10)                NOT NULL
  COMMENT \'项目阶段，暂时废弃;project stage, temply deprecated.  1-design 2-developing 3-debug\'
    DEFAULT 1,
  project_data   LONGTEXT               NULL
  COMMENT \'项目JSON数据，存放当前最新的版本。 project JSON data, saved the newest version of the project\',
  group_id       INT(10)                NULL
  COMMENT \'分组ID group id\',
  related_ids    VARCHAR(128)           NOT NULL
  COMMENT \'路由ID，用于指定与哪些项目共享mock数据; router id, used for specify sharing data with which projects.\'
    DEFAULT \'\',
  update_time    DATETIME               NOT NULL
  COMMENT \'更新时间 update time\',
  mock_num       INT                    NOT NULL
  COMMENT \'mock次数 mock num\'
    DEFAULT 0,
  access_type    TINYINT                NOT NULL
  COMMENT \'权限控制, 10普通, 0私有\'
    DEFAULT 10,

  FOREIGN KEY (user_id) REFERENCES tb_user (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * user list and user table
 * used for creating multiple to multiple mapping
 * access_level:
 *     1 - read
 *     2 - read&write
 *     3 - read&write&manage
 */
CREATE TABLE tb_project_and_user
(
  project_id   INT(10) NOT NULL,
  user_id      INT(10) NOT NULL,
  access_level INT     NOT NULL
    DEFAULT 1,

  PRIMARY KEY (project_id, user_id),
  FOREIGN KEY (project_id) REFERENCES tb_project (id),
  FOREIGN KEY (user_id) REFERENCES tb_user (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * module table
 */
CREATE TABLE tb_module
(
  id           INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  project_id   INT(10)                NOT NULL,
  name         VARCHAR(256)           NOT NULL,
  introduction VARCHAR(128)           NULL,

  FOREIGN KEY (project_id) REFERENCES tb_project (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * page table
 */
CREATE TABLE tb_page
(
  id           INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  name         VARCHAR(56)            NOT NULL,
  module_id    INT(10)                NOT NULL,
  introduction TEXT                   NULL,
  template     VARCHAR(128)           NULL,

  FOREIGN KEY (module_id) REFERENCES tb_module (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * action table
 * request_type:
 *     1 - get
 *     2 - post
 *     3 - ajax get
 *     4 - ajax post
 */
CREATE TABLE tb_action
(
  id                INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  name              VARCHAR(256)           NOT NULL,
  description       TEXT                   NULL,

  /* request block */
  request_type      INT                    NOT NULL
  COMMENT \'请求类型get/post/put/delete等等 request type\'
    DEFAULT 1, /** request_type = 99, mount type **/
  request_url       TEXT                   NULL,

  disable_cache     TINYINT                NOT NULL
  COMMENT \'禁用Mock缓存 disable mock cache\'
    DEFAULT 0,

  /* response block */
  response_template TEXT                   NULL
  COMMENT \'响应模板地址, 暂时弃用。 response template address, temply deprecated.\'

)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * action and page table
 * used for creating multiple to multiple mapping
 */
CREATE TABLE tb_action_and_page
(
  action_id INT(10) NOT NULL,
  page_id   INT(10) NOT NULL,

  FOREIGN KEY (action_id) REFERENCES tb_action (id),
  FOREIGN KEY (page_id) REFERENCES tb_page (id),
  PRIMARY KEY (action_id, page_id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;


/**
 * parameter and parameter mapping
 * complex_parameter has so many parameters(List<Map> or Map)
 */
CREATE TABLE tb_complex_parameter_list_mapping
(
  complex_parameter_id INT(10) NOT NULL,
  parameter_id         INT(10) NOT NULL,

  PRIMARY KEY (complex_parameter_id, parameter_id),
  FOREIGN KEY (complex_parameter_id) REFERENCES tb_parameter (id),
  FOREIGN KEY (parameter_id) REFERENCES tb_parameter (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * parameter and action\'s request mapping
 */
CREATE TABLE tb_request_parameter_list_mapping
(
  action_id    INT(10) NOT NULL,
  parameter_id INT(10) NOT NULL,

  PRIMARY KEY (action_id, parameter_id),
  FOREIGN KEY (action_id) REFERENCES tb_action (id),
  FOREIGN KEY (parameter_id) REFERENCES tb_parameter (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * parameter and action\'s response mapping
 */
CREATE TABLE tb_response_parameter_list_mapping
(
  action_id    INT(10) NOT NULL,
  parameter_id INT(10) NOT NULL,

  PRIMARY KEY (action_id, parameter_id),
  FOREIGN KEY (action_id) REFERENCES tb_action (id),
  FOREIGN KEY (parameter_id) REFERENCES tb_parameter (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;


/**************************************************
 *                                                *
 *          workspace module                      *
 *                                                *
 **************************************************/


/**
 * workspace, deprecated 工作区，暂时未使用
 */
CREATE TABLE tb_workspace
(
  id                    INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  project_id            INT(10)                NOT NULL,
  user_id               INT                    NOT NULL,
  create_date           TIMESTAMP              NOT NULL
    DEFAULT now(),
  update_date           DATETIME               NOT NULL,
  project_data          LONGTEXT               NOT NULL,
  project_data_original LONGTEXT               NOT NULL,

  FOREIGN KEY (project_id) REFERENCES tb_project (id),
  FOREIGN KEY (user_id) REFERENCES tb_user (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * workspace save, deprecated 工作区保存草稿，暂时未使用
 */
CREATE TABLE tb_workspace_save
(
  id           INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  workspace_id INT(10)                NOT NULL,
  update_date  DATETIME               NOT NULL,
  project_data LONGTEXT               NOT NULL,

  FOREIGN KEY (workspace_id) REFERENCES tb_workspace (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * check in table
 * every API document submit saved here, used for version control.
 * 每一次提交记录在这里，用于版本管理和回滚控制
 * workspaceMode 1-VSS 2-SVN
 */
CREATE TABLE tb_check_in
(
  id             INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  create_date    TIMESTAMP              NOT NULL
    DEFAULT now(),
  tag            VARCHAR(128)           NULL
  COMMENT \'tag标签 暂时未使用 deprecated\',
  user_id        INT(10)                NOT NULL
  COMMENT \'提交人 submit user id\',
  project_id     INT(10)                NOT NULL
  COMMENT \'提交的项目ID submit project id\',
  description    TEXT                   NULL
  COMMENT \'提交描述 submit description\',
  version        VARCHAR(128)           NOT NULL
  COMMENT \'版本号 version no.\',
  project_data   LONGTEXT               NOT NULL
  COMMENT \'项目JSON数据 project json data\',
  workspace_mode INT(10)                NOT NULL
  COMMENT \'工作区模式(弃用) workspace mode(deprecated)\',
  log            TEXT                   NULL
  COMMENT \'更新日志，用于存储与最近一个版本的对比差异。暂时未使用。update log, used for calculate versions differences. Deprecated.\',

  FOREIGN KEY (user_id) REFERENCES tb_user (id),
  FOREIGN KEY (project_id) REFERENCES tb_project (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * user settings table
 * 用户配置表
 */
CREATE TABLE tb_user_settings
(
  user_id INT(10)      NOT NULL,
  `key`   VARCHAR(128) NOT NULL
  COMMENT \'配置KEY config key\',
  `value` VARCHAR(128) NOT NULL
  COMMENT \'配置VALUE config value\',

  PRIMARY KEY (user_id, `key`),
  FOREIGN KEY (user_id) REFERENCES tb_user (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * user notification table
 * 用户通知表
 */

CREATE TABLE tb_notification
(
  id             INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  user_id        INT(10)                NOT NULL
  COMMENT \'接受通知的用户id; user id to be notified.\',
  target_user_id INT(10)                NOT NULL
  COMMENT \'上下文用户id; context user id\',
  type_id        SMALLINT               NOT NULL
  COMMENT \'1-文档修改,2-被加入新项目\',
  param1         VARCHAR(128)           NULL
  COMMENT \'1,2-项目id\',
  param2         VARCHAR(128)           NULL
  COMMENT \' 1,2-项目名称\',
  param3         TEXT                   NULL
  COMMENT \'备用预留 reserved\',
  create_time    TIMESTAMP              NOT NULL
  COMMENT \'创建时间 create time\'
    DEFAULT now(),

  is_read        SMALLINT               NOT NULL
  COMMENT \'是否已读 is notification read\'
    DEFAULT 0,

  FOREIGN KEY (user_id) REFERENCES tb_user (id),
  FOREIGN KEY (target_user_id) REFERENCES tb_user (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * corporation table
 * 公司表
 */
CREATE TABLE tb_corporation
(
  id          INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  name        VARCHAR(256)           NOT NULL,
  logo_url    VARCHAR(256)           NULL,
  user_id     INT(10)                NULL,
  access_type TINYINT                NOT NULL
  COMMENT \'权限控制, 10普通, 20公开\'
    DEFAULT 10,
  `desc`      TEXT                   NOT NULL
  COMMENT \'备注\',

  FOREIGN KEY (user_id) REFERENCES tb_user (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;


/**
 * product line table
 * 生产线表
 */
CREATE TABLE tb_production_line
(
  id             INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  name           VARCHAR(256)           NOT NULL,
  project_num    INT(10)                NOT NULL
    DEFAULT 0,
  corporation_id INT(10)                NOT NULL,
  user_id        INT(10)                NOT NULL,

  FOREIGN KEY (user_id) REFERENCES tb_user (id),
  FOREIGN KEY (corporation_id) REFERENCES tb_corporation (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * project group table
 * 项目分组表
 */
CREATE TABLE tb_group
(
  id                 INT(10) AUTO_INCREMENT NOT NULL
    PRIMARY KEY,
  name               VARCHAR(256)           NOT NULL,
  production_line_id INT(10)                NOT NULL,
  user_id            INT(10)                NOT NULL,

  FOREIGN KEY (user_id) REFERENCES tb_user (id),
  FOREIGN KEY (production_line_id) REFERENCES tb_production_line (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

/**
 * 规则表，存储通过Open API设置的Mock规则
 * Stored mock rules set by Open API
 */
CREATE TABLE tb_rule (
  action_id   INT(10)  NOT NULL
    PRIMARY KEY,
  rules       TEXT     NOT NULL, -- JSON规则
  update_time DATETIME NOT NULL
    DEFAULT NOW(), -- 最近更新时间

  FOREIGN KEY (action_id) REFERENCES tb_action (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;

CREATE TABLE tb_corporation_and_user
(
  user_id        INT(10) NOT NULL,
  corporation_id INT(10) NOT NULL,
  role_id        INT(10) NOT NULL,

  PRIMARY KEY (user_id, corporation_id),
  FOREIGN KEY (user_id) REFERENCES tb_user (id),
  FOREIGN KEY (corporation_id) REFERENCES tb_corporation (id),
  FOREIGN KEY (role_id) REFERENCES tb_role (id)
)
  ENGINE = InnoDB
  DEFAULT CHARSET = utf8;


-- required base data
INSERT INTO tb_role (name) VALUES (\'god\');
INSERT INTO tb_role (name) VALUES (\'admin\');
INSERT INTO tb_role (name) VALUES (\'user\');
-- removed unused qa/pm/rd roles


INSERT INTO tb_user (account, password, email, create_date, last_login_date, name) VALUES
  (\'admin\', \'RESERVED\', \'[e-mail]\', NOW(), NOW(), \'admin\');

INSERT INTO tb_role_and_user (user_id, role_id) VALUES (1, 1);

-- INSERT INTO tb_corporation (name, logo_url, user_id) VALUES (\'MyTeam\', \'empty\', 1);
-- 新版RAP可以自建团队，不需要插入默认团队了。
-- RAP v0.11.5+ users can create teams by their own, so there\'s no need to set default team.

View Code

然后再执行一下下面这句

SET @@global.sql_mode = \'STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION\';

好 看看本地数据是否有了对应的表接口如图：

2 里面说的安装redis 地址就是坑有没有呢？

下载地址：https://github.com/dmajkic/redis/downloads （下载好对应的文件 进行解压后 把比如我的电脑是64位的那把这个文件拷贝到D:盘的一个新文件夹中）

然后作者应该是笔误了 关于执行路径写错了 下图应该是第二个执行命令 注意顺序（在自己的文件夹中去执行对应的命令）

 

最后三个服务一起启动好了，如果登陆不成功 很正常重新注册一个用户，然后验证有点小坑 不过不影响大局给！

最后的最后 希望大家安装愉快！

 

工具包集合：百度云盘下载地址

链接：http://pan.baidu.com/s/1i5scmKP 密码：uzhm