Mkp-restful-client NPM

restful-client

RESTful client with javascript,Redux is supported,you could use it in all of javascript projects especially React and React Native.

Install

$ npm install mkp-restful-client --save

Quick Start

//import RESTful client
import RESTfulClient from "mkp-restful-client";
//initial RESTful client
//default client is fetch
let rest=new RESTfulClient();

window.$rest=rest;

//request a json
rest.request({
    url:"https://api.github.com/users/mralexgray/repos"
}).then(response=>{
    console.log(response);
})

Client

There have two client fetch and superagent , fetch is default client.

let rest=new RESTfulClient();

let rest=new RESTfulClient({
	clientEngine:{
		name:"fetch",
		client:fetch
	}
});

code with superagent following

import superagent from "superagent";
let rest=new RESTfulClient({
	clientEngine:{
		name:"superagent",
		client:superagent
	}
});

RESTful client Events

beforeSend(requestConf,dispatch) - invoke before request , you can override the request options in this time.
sending(requestConf,xhr,dispatch) - immediately invoke when the request is sent.
received(requestConf,response,xhr,dispatch) - immediately invoke when the response is return.
success(response,dispatch) - invoke when request is successful.
error(err,dispatch) - invoke when request error is occurred.
complete(requestConf,dispatch) - invoke when all of them is done.
normalizeResponse(response) - normalize response

let rest =new RESTfulClient({
	normalizeResponse(response){
		//you can override response 
		
		//example
		//return response.json().then(json=>{
		//	response.body=json;
		//	return response;
		//});
		//or
		//response.data=response.body.Data;
		//return response;
	},
    beforeSend(options, dispatch){
    	//you could override the opstions
    	//such as combine url
    	//options.url=host+options.url;
    	//do somethings
    },
    sending(options, xhr, dispatch){
    	//you could show a loading or store xhr and so on
    	//do somethings
    },
    received(options, response, xhr, dispatch){
    	//if show a loading at sending , you must remove that in here.
    	//do somethings
    },
    success(response, dispatch){
    	//how to read response header's values?
    	//example:
    	//response.header["HEADER_NAME"]
    	//in addtion you can read response.text , response.body and so on.
    	//you can inspect these property through console.
    	
    	//do somethings
    },
    error(err, dispatch){
    	//do somethings
    },
    complete(options, dispatch){
    	//do somethings
    }
})