Add convention to you express routes
Inspired by ActionController, this library provides the conventions that your express app's route config has been missing.
One of the key selling points of Ruby on Rails in Convention over Configuration. It holds strongs opinions and by doing so, if you follow the conventions, your app will do things automatically. On the other hand, Express docs and tutorials don't really hold any options at all on how to organize code; in fact, most tutorials seem to rely on anonymous functions bound directly to routes.
At some point, your app will get too big to just wire anonymous functions to
routes. See usage for how Controller can help.
npm install @ianwremmel/tracks-controllerThis library exports a configuration function that asynchronously produces an
express router. Its root parameter points to the directory containing your
controllers
import {configure as configureRouteControllers} from '@ianwremmel/tracks-controller';
import path from 'path';
// Take a look @ianwremmel/tracks-boot for a cleaner way to do async loading
(async function boot() {
const app = express();
app.use(
'/',
await configureRouteControllers({
// extensions defaults to '.js', but you might want to incldue '.ts'
// files, for example, if your dev setup does JIT compilation
extensions: ['js'],
root: path.join(__dirname, 'controllers'),
})
);
app.listen(3000);
})();Your controllers should inherit from ResourceController. They'll follow one of
the following routing tables.
Routing is taken directly from the
rails conventions.
Unlike rails, Controller doesn't let you provide a route config; everything is
routed based on file location.
| HTTP Verb | Path | Controller#Action | Used for |
|---|---|---|---|
| GET | /photos | photos#index | display a list of all photos |
| GET | /photos/new | photos#new | return an HTML form for creating a new photo |
| POST | /photos | photos#create | create a new photo |
| GET | /photos/:id | photos#show | display a specific photo |
| GET | /photos/:id/edit | photos#edit | return an HTML form for editing a photo |
| PATCH/PUT | /photos/:id | photos#update | update a specific photo |
| DELETE | /photos/:id | photos#destroy | delete a specific photo |
However, we do provide one convenince that rails doesn't. If you set
Controller.singleton to true, your controller will follow a different
routing table that makes sense for things like the current user's profile page.
| HTTP Verb | Path | Controller#Action | Used for |
|---|---|---|---|
| GET | /new | profile#new | Return an HTML form for creating a new profile |
| POST | / | profile#create | Create a new profile |
| GET | / | profile#show | Display the current user's profile |
| GET | /edit | profile#show | Return an HTML form for editing the current user's profile |
| PATCH/PUT | / | profile#update | Update the current user's profile |
| DELETE | / | profile#destroy | Delete the current user's profile |
To create a controller and automatically route to it, simply add a file at the
corresponding path location in your controllers directory and inherit from
ResourceController. Then, implement the above-mentioned methods to begin
serving pages.
Your controller must be the default export and must be named according to its path: remove the slashes, make everything PascalCase, and put "Controller" on the end.
/**
* @file 'users/photos.js'
*/
import {ResourceController} from '@ianwremmel/tracks-controller';
export default UserPhotosController extends ResourceController() {
async create(req, res) {
// TODO something with the photo
res.status.send(201).end
}
}A previous version of this library attempted to provide automatic view rendering in controller form, but all of the bits needed to make it work reasonably had to be too intertwined in the main project for it to stand alone. It may return as its own library at some point. In the meantime, consider something like the following for defining a minimal view controller:
export class ViewController extends ResourceController {
static async init(req: Request, res: Response) {
const controller = new this(req, res);
return new Proxy(controller, {
get(target, prop, receiver) {
const value = Reflect.get(target, prop, receiver);
if (isRouteAction(prop)) {
const viewName = `${routify(
target.constructor.name
)}/${prop}`;
return async () => {
if (!value) {
throw new NotFound();
}
await value.call(target, req, res);
if (res.headersSent) {
return;
}
target.logger.info(`rendering ${viewName}`);
/*
this is where things break down keeping
ViewController in the library; no good way of
customizing locals presented itself at thetime and
they're critical for Views
*/
const locals = {};
target.res.render(viewName, locals);
};
}
return value;
},
});
}
}PRs Welcome
MIT © Ian Remmel 2019 until at least now
![dependabot-preview[bot] avatar](https://avatars.githubusercontent.com/in/2141?v=4 "dependabot-preview[bot]")
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent