Json-rpc
Flexible client, server objects for json-rpc communications between node.js servers with support for https.
Install
$ npm install node-json-rpc
Info
Node-json-rpc is designed to be compatible with specs defined at jsonrpc.org. To add flexibility we added the option to run the apps in strict mode or to turn it off. When not using strict mode allot of the bloat in the spec can be removed and more flexibility can be achieved.
To get started have a look at the minimal example down below or the more complete example in the test directory.
Server Setup
For all posible options please read the notes in ./lib/rpcserver.js or look at test files to see a example.
var rpc = require('node-json-rpc');
var options = {
port: 5080,
host: '127.0.0.1',
path: '/',
strict: true
};
var serv = new rpc.Server(options);
serv.addMethod('myMethod', function (para, callback) {
var error, result;
if (para.length === 2) {
result = para[0] + para[1];
} else if (para.length > 2) {
result = 0;
para.forEach(function (v, i) {
result += v;
});
} else {
error = { code: -32602, message: "Invalid params" };
}
callback(error, result);
});
serv.start(function (error) {
if (error) throw error;
else console.log('Server running ...');
});
Client Setup
For all posible options please read the notes in ./lib/rpcclient.js or look at test files to see a example.
var rpc = require('node-json-rpc');
var options = {
port: 5080,
host: '127.0.0.1',
path: '/',
strict: true
};
var client = new rpc.Client(options);
client.call(
{"jsonrpc": "2.0", "method": "myMethod", "params": [1,2], "id": 0},
function (err, res) {
if (err) { console.log(err); }
else { console.log(res); }
}
);
client.call(
{"method": "myMethod", "params": [1,2]},
function (err, res) {
if (err) { console.log(err); }
else { console.log(res); }
}
);
License
Copyright (c) 2013, Koen Van Rulo (@NemoPersona) All rights reserved.
This product is free and open-source software released under the BSD license.