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


     我这里要用做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', 'admin@example.com', 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

  • 相关阅读:
    os 模块
    time-时间模块
    hashlibloggingconfigparser
    模块-json,pickle
    转载:执行脚本出现bin/bash: bad interpreter: No such file or directory
    转载:如何查看用户当前shell和修改用户登陆时的默认shell
    转载:对#!/bin/sh的认识
    转载:mysql-Auto_increment值修改
    转载:Tomcat多数据源配置方法
    转载:struts2和spring的结合原理(精品)
  • 原文地址:https://www.cnblogs.com/zxyun/p/5833062.html
Copyright © 2020-2023  润新知