http-microservice-client's Introduction

http-microservice-client

An enjoyable HTTP client for restfull microservice to make request to http microservice without any codes.

All HTTP requests in json file will be generated a Promise function in this client.

Installation

Requires node v6.1.0 or higher for ES6 and generator function support.

$ npm install http-microservice-client

Example

    const config = {
        foo:{
            host:'http://localhost:8080',
            api:[
                {
                    name:'bar',
                    path:'/bar/:id',
                    headers:['Authorization']
                },
                {
                    name:'bazz',
                    path:'/bazz',
                    method:'POST'
                }
            ]
        }
    }

    const Microservice = require("http-microservice-client");
    const client = new Microservice( config );
    
    
    try {
        let barResBody = yield client.foo.bar({id:'1',Authorization:'token'})
    } catch ( e ) {
    
        let statusCode = e.code;
        let message = e.message;
        console.log(statusCode, message);
    }
    
    try {
        let bazzResBody = yield client.foo.bazz({x:1,y:2});
    } catch ( e ) {
    
        let statusCode = e.code;
        let message = e.message;
        console.log(statusCode, message);
    }

In api config default method is 'GET'. The Object of agument you passed to the generated function will append to qs of request if the method is 'GET' or 'DELETE', but it will be body oppositely. It should explicate headers in api config if the request is needed.

It will throw a RequestError when the response.statusCode is not 2xx. RequestError contains a code which equls to the response.statusCode and a message from response.

License

MIT

Recommend Projects

fengshux / http-microservice-client Goto Github PK