justreq(JR Server)

相信各位程序猿、攻城狮都有遇到过接口服务器不给力的情况。有时接口服务器宕机，我们只能干瞪眼。有时也会想，如果能把接口拷贝到本地，那该多好。但是，先不说在本地运行接口服务代价有多大，接口一旦升级，又得再拷贝一次。为什么不能既能即时更新最新接口，又能不惧接口离线呢？答案是可以！
为了解决上述问题，我用业余时间开发了justreq。就像它的名字一样：“just request”，never offline!，它可以帮助你实现接口永不离线的梦想。
其原理就是在本地进行接口缓存，当接口服务处于离线状态时，它将直接从本地调取缓存。默认20分钟更新一次缓存，对于服务器来说，也大大减轻了负担。

特性

• 自动缓存每一次接口请求，当测试服务器宕机时，依然可以从容开发

• 接口替身服务，当后台GG们还没开发好接口时，可以用json、txt等替代

• 独有jrs脚本，仿php，可以定制更灵活的接口替身，甚至可以用来开发小型站点

• 支持ES6、ES7，开发更高效

• 支持CORS跨域，前端开发也可以放心使用

• 支持https，无论接口采用http还是https，都能从容应对

安装

首先下载安装Node.js，然后运行以下命令安装justreq命令行工具

npm install -g justreq-cli

运行以下命令安装主程序

npm install justreq

初始化

运行以下命令进行初始化

justreq init

配置完成后，将在当前目录生成“.justreq”文件，你可以随时按自己需求进行配置

使用

运行以下命令启动justreq

justreq start

然后把你的接口地址直接指向justreq服务（JR Server）即可。例如：

// const API_HOST = "https://test.yourhost.com";
const API_HOST = "http://127.0.0.1:8000";
$.get(API_HOST + "/getInfo.do?userId=1001", callback);

如果需要在启动的同时更新缓存，可以用以下命令

justreq start -c

如果接口地址临时改动了，而你又不想修改配置文件，可以用以下命令

justreq start -h temp.yourhost.com

可运行如下命令查看更多命令行参数

justreq start --help

进阶玩法

JRS脚本

接下来要郑重推荐我们独创的jrs脚本了。该脚本基于javascript，因此你完全不需要任何学习成本即可上手。先来一段：

// getUser.jrs
var userId = $_GET['userId'];
var users = {
    1001 : {name:'zhangsan', age: 22},
    1002 : {name:'lily', age: 21}
};
var user = users[userId];
setCookie('userName', user.name);
echo(JSON.stringify(user));
end();

除了你所熟知的javascript对象外，我们新增加了一些必要的全局函数、属性

属性

方法

由于jrs脚本完全基于js，并运行于Node.js环境，因此，你可以使用Node.js下面的一切优秀模块来进行开发。
并且，只要你的Node.js版本支持，你也可以使用ES6/ES7来编写jrs

RULES配置

为了更好的发挥justreq的功能，我们提供了一些配置规则

以下是一份样例：

// .justreq
{
    ...
  "rules": [
    {
      "href":       "user.do\?id=(\d+)",
      "subs":       "user.jrs?userId=$1"
    },
    {
      "href":       "login.do",
      "noCache":    true
    },
    {
      "href":       "getGoodsInfo.do",
      "ignoreArgs": "v,token,timestamp"
    }
  ]
}

其它配置项