groa-router

Router middleware for Groa gRPC framework.

Requirement

Node.js v7.6+ is required, the middleware system of Gora is based on async function.

Installation

Install via NPM:

npm install groa-router --save

Usage

Create a router to manage your gRPC service and corresponding methods:

const Groa = require('groa');
const Router = require('groa-router');
 
const app = new Groa();
const router = new Router();
 
// Add proto file
app.addProto(__dirname + '/example.proto');
 
// package: example.foo
// service: Example1
// method: echo
router.rpc('/example.foo.Example1/Echo', async (ctx) => {
 
    console.log('Echo');
    ctx.body = ctx.req.body;
});
 
// Add router middleware
app.use(router.routes());
 
app.listen(50051, () => {
    console.log('Listening on port 50051');
});

example.proto

syntax = "proto3";
 
package example.foo;
 
service Example1 {
    rpc Ping(Echo) returns (Echo) {}
    rpc Echo(Echo) returns (Echo) {}
    rpc Hello(Hello) returns (Hello) {}
}
 
message Echo {
    string content = 1;
}
 
message Hello {
    string msg = 1;
}

Router Prefixes

Route paths can be prefixed at the router level:

// package: example.foo
// service: Example1
const router = new Router({
    prefix: 'example.foo.Example1'
});
 
// method: echo
router.rpc('echo', async (ctx) => {
 
    console.log('Echo');
    ctx.body = ctx.req.body;
});

License

Licensed under the MIT License

Authors

Copyright(c) 2017 Fred Chien（錢逢祥） <[e-mail]>