express-routes-mapper
A simple package to map your routes for your expressjs application
Getting started
Install
$ npm i -S express-routes-mapper
or
$ yarn add express-routes-mapper
Use
After the installation you can import the package to your express project.
Routes
Create your routes file:
const routes = {
'POST /user': 'UserController.create'
};
export default routes;
Every post request to your server to route '/user' will call the function 'create' on the 'UserController'.
Controller
Create a file named UserController.js
export default class UserController {
create (req, res) {
res.send('created a User with es6 class syntax');
};
};
const UserController = () => {
const create = (req, res) => {
res.send('created a User with without es6 class syntax');
};
return {
create,
};
};
export default UserController;
Express with mapped Routes
I assume you have a folder structure like this, but it can be adapted to any folder structure.
.
+-- src
| +-- config
| | +-- routes.js
| |
| +-- controllers
| | +-- UserController.js
| |
| +-- models
| |
| app.js
|
package.json
Your app.js could look a bit like this:
The magic happens here:
import routes from './config/routes';
the file where all the routes are mappedimport mapRoutes from 'express-routes-mapper';
the package that makes the mapping possibleconst mappedRoutes = mapRoutes(routes, 'src/controllers/');
tell router to use your routesapp.use('/', mappedRoutes);
tell express to use the mapped routes
import express from 'express';
import http from 'http';
import mapRoutes from 'express-routes-mapper';
import routes from './config/routes';
const app = express();
const server = http.Server(app);
const port = 4444;
const mappedRoutes = mapRoutes(routes, 'src/controllers/');
app.use('/', mappedRoutes);
server.listen(port, () => {
console.log('There we go ♕');
console.log(`Gladly listening on http://127.0.0.1:${port}`);
});
Supported methods
const routes = {
'GET /someroute' : 'SomeController.somefunction',
'POST /someroute' : 'SomeController.somefunction',
'PUT /someroute' : 'SomeController.somefunction',
'DELETE /someroute' : 'SomeController.somefunction',
};
Dynamic Routes
Simply use a colon :
for defining dynamic routes.
const routes = {
'GET /someroute/:id' : 'SomeController.someFunction',
};
If you make a get request to http://localhost/someroute/1
the number 1
(:id) is now in the SomeController
accessible.
const SomeController = () => {
const someFunction = (req, res) => {
const id = req.params.id;
};
return {
someFunction,
};
};
export default SomeController;