Awesome
Picker - Server Side Router for Meteor
Picker is an easy to use server side router for Meteor. This router respect others. So, you can use Iron Router and other routers and middlewares along side with this.
DEPRECATED
As of Meteor 3, Picker is deprecated as the functionality that has been provided by it is now part of Meteor itself and the Express server that is baked into it.
Install
meteor add communitypackages:picker
Getting Started
Picker.route('/post/:_id', function(params, req, res, next) {
const post = Posts.findOne(params._id);
res.end(post.content);
});
- You can use Meteor APIs inside this callback (runs inside a Fiber)
- Route definitions are very similar to Iron Router and Express
req
is an instance of NodeJS http.IncomingMessageres
is an instance of NodeJS http.ServerResponsenext
is optional and call it, if you don't need to handle the current request
Filtering and Sub Routes
This is a unique functionality of this router. See following example:
Let's say we need to handle only POST
requests. This is how you can do it with Picker
.
const postRoutes = Picker.filter(function(req, res) {
// you can write any logic you want.
// but this callback does not run inside a fiber
// at the end, you must return either true or false
return req.method === "POST";
});
postRoutes.route('/post/:id', function(params, req, res, next) {
// ...
});
You can create any amount of sub routes with this filter
API. Same time, you can create nested sub routes as well.
Middlewares
You can use existing connect
and express
middlewares without any issues.
import bodyParser from 'body-parser';
// Add two middleware calls. The first attempting to parse the request body as
// JSON data and the second as URL encoded data.
Picker.middleware( bodyParser.json() );
Picker.middleware( bodyParser.urlencoded( { extended: false } ) );
You can use middlewares on sub routes as well.