Repository files navigation

查看中文版

A caching proxy server for testing interface of HTTP or HTTPS. A never offline testing interface server. A mock server. It can help us to develop offline. It's especially useful for Front-End developers.

• Each request will be cached. It can make us be absorbed in develop whether online or offline.
• Mock server. We can use other file to mock interface, such as JSON, TXT and so on.
• We make an script named JRS, just like PHP. It can mock more flexible interface, and even develop a site.
• Support for ES6, ES7, can develop more efficient.
• Support for CORS(Cross-Origin Resource Sharing), so it can work for Web Front-End.
• No invasive codes, do not inject any code to our project.

InstallNode.js first, then run this to install CLI of JUSTREQ

npm install -g justreq-cli

Install main program using:

npm install justreq

To create a configuration file using:

justreq init

After finished, the configuration file ".justreq" will be created at working directory. We can modify it any time. And, we can add comment using JavaScript style.

To start a JR Server using:

justreq start

Then modify our testing interface to JR Server, eg.

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

Now, all ready, enjoy your coding.

Also, we can run this to clean caches and start JR server

justreq start -c

Or, run this to temporarily proxy other remote not in configuration file

justreq start -h temp.yourhost.com

We can run this to get help

justreq start --help

Now, I will introduce ourjrs. It's Javascript-based, so we can use it without study any more. Let me show:

// getUser.jrsvaruserId=$_GET['userId'];varusers={1001 :{name:'Bruce',age:22},1002 :{name:'Lily',age:21}};varuser=users[userId];setCookie('userName',user.name);echo(JSON.stringify(user));end();

We added some necessary global function and properties, except usual of JS.

Forjrs, we can use any modules from Node.js, because it run in Node.js runtime environment. Such asFaker.js,mockjs and so on.And, we can code with ES6, ES7 also, if Node.js enough new.

For some special interface, we can rule it using:

Example:

// .justreq{    ..."rules":[{// for default, always try to proxy to keep fresh"url":".+","keepFresh":true},{// using RegExp"url":"user.do\\?id=(\\d+)","subs":"user.jrs?userId=$1"},{"url":"login.do","noCache":true},{"url":"getGoodsInfo.do","ignoreArgs":"v,token,timestamp"},{// all api that include 'system' in url will be proxy to another host"url":"system.+","host":"192.168.1.188","port":"8080"}]}

Sometimes, we need another way to decide whether cache the client request or not. Such as follow case. The post data is encode with base64, but a field is insignificant. If we do not intervene to inspect, JUSTREQ will cache repeat.

// myInsp.jsconstquerystring=require('querystring');constcrypto=require('crypto');constbase64=require('base64-utf8');functionmd5(str){letmd5sum=crypto.createHash('md5');md5sum.update(str);str=md5sum.digest('hex');returnstr;}functioninsp(req,buf){letrawData=buf.toString('utf8');// token=F2F0CF28&encrypt=eyJhcnRpY2xlSWQiOjk5LCJtaXN0IjoiWTJodiJ9letpostData=querystring.parse(rawData);// {token:"F2F0CF28", encrypt:"eyJ..."}if(postData.encrypt){letdecodeString=base64.decode(postData.encrypt);letpayload=JSON.parse(decodeString);// {"articleId":99,"mist":"Y2hv"}letmd5Code=md5(req.method+req.url+payload.articleId);return{needCache:true,cacheId:md5Code};// need to be cached}else{returnnull;// inspector should skip this request}}module.exports=insp;// Must be exported it as node module

And add a configurition to ".justreq"

{..."inspector":".jr/myInsp.js"}

/** *@param  {object} req The req create by client request *@param  {buffer} buf The data from FormData *@return {json}       {needCache: <boolean>, cacheId: <md5>} or null */functioninsp(req,buf){  ...return{needCache:<boolean>, cacheId:<md5>};}module.exports=insp;// Must be exported it as node module

• Expect the value of "cacheId" by return as an md5 code. Recommendmd5(req.method + req.url + bufData), to avoid conflict from cache.
• To skip inspect, we can just return null.
• To avoid http choke, we can't use any asynchronous code andsetTimeout,setInterval.

There are some demo in "./examples" directory.

Open the directory and openrun_examples.cmd(shell./run_examples for Linux) to start JUSTREQ. Also, we can start JUSTREQ usingjustreq start.

Now, we can open any html files to experience.

jrs.html,substitutes.html,upload.html

justreq - github

issue

Chinese

blog[CN]

Released under the