msgpack-response v1.0.4
msgpack-response
An implementation of Message Pack middleware for ExpressJS.
Features
- Automatic Message Pack detection (from the HTTP headers) and encoding of all JSON messages to Message Pack.
- Extension of the current ExpressJS API; Introducing the
Response.msgPack(jsObject)method on the standard ExpressJS Response object.
Getting Started
With auto-detection and transformation enabled, the middleware detects automatically the HTTP header Accept: application/x-msgpack and piggybacks the Response.json() method of the ExpressJS API, to encode the JSON response as Message Pack. This method is useful when you have existing applications that need to use the middleware, without changing the codebase very much.
const msgpackResponse = require('msgpack-response');
app.use(msgpackResponse({auto_detect: true}));
app.get('/test_json', (req, res) => {
res.status(200).json({'message': 'a true test'});
})Note: Remember to add the header
Accept: application/x-msgpackin the request.
Also, it can have auto-detection and transformation disabled. The middleware extends the Response object of the ExpressJS framework, by adding the msgPack() method to it. Then to return an encoded response, you just use the Response.msgPack() method that accepts the Javascript object as a parameter. For example,
const msgpackResponse = require('msgpack-response');
app.use(msgpackResponse({auto_detect: false}));
//or
app.use(msgpackResponse());
app.get('/test_msgpack', (req, res) => {
res.status(200).msgPack({'message': 'a true test'});
});Note: Initialize the middleware before the actual routes in the middleware chain to properly extend the
ResponseObject.
Requirements
Node.js >= 6.0
Installation
With npm do:
npm install msgpack-response -saveAbout
I :heart: open source software!
Check out my other open source projects or say :wave: on twitter.
Contribute
Contributions are welcome :metal:. Please see the Contributing Guide and the Code of Conduct.
Authors
- Stavros Schizas - Initial work & Maintainer
- Vassilios Karakoidas - Initial work - Wizhut
See also the list of contributors who participated in this project.
License
msgpack-response is available under the MIT license. See the LICENSE file for more info.