json-rest-light
This library was made for building JSON REST over HTTP server, easier, lighter, and with relaxing.
By using this library, you will be able to build the JSON REST server JUST 3 steps.
- Implement functions.
- Determin
METHOD
andpathname
. - Write server start script.
Concept & Policy of this Library
-
Light-weight
- No Redundancy
- No Dependency (pure Node.js)
-
async/await style
- using async/await.
- Promise based. (Node version 7.6 later)
Install
Clone this project and build in your project,
or down-load by npm
bellow.
npm i --save json-rest-light
Getting Start
Here is a very tiny sample server that return 'hello JSON'.
const util = require('util');
const {JsonRestServer} = require('json-rest-light');
// -------------------------------------
// 1. Implement functions.
function seyHello (input) {
return new Promise((resolve, reject) => {
let output = {
greating: 'Hello !!!!'
}
if( input.name != undefined) {
output.message = util.format('%s san konnichiwa !!!!', input.name);
}
resolve(output)
});
}
// -------------------------------------
// 2. Determin `METHOD` and `pathname`.
const server = new JsonRestServer({port: 8080});
server.addAPI('/sey_hello', 'GET', seyHello)
// -------------------------------------
// 3. Write server start script.
server.start( () => {
console.log('JSON API server started.');
console.log('try GET to access http://localhost:8080/sey_hello?name=kazumatu981');
});
Save the file (for example the file name is sample.js
), and start the script.
node sample.js
If you try,
$ curl http://localhost:8080/seyhello?name=kazumatu981
The server will return.
{
"status": "success",
"data": {
"greating": "Hello !!!!",
"message": "kazumatu981 san konnichiwa !!!!"
}
}
The return JSON formated JSend, JSend in Japanese
See, JUST 3 STEP
Specification
see Here
CHANGELOG
Future works
- https support
--- ver 2.0.2