server/web/resource-route-generator.js

   1 'use strict';
   2
   3 var express = require('express');
   4 var StatusError = require('statuserror');
   5 var identifyRoute = require('gitter-web-env').middlewares.identifyRoute;
   6 var Promise = require('bluebird');
   7
   8 module.exports = function resourceRoute(routeIdentifier, resource) {
   9   var router = express.Router({ caseSensitive: true, mergeParams: true });
  10   var idParam = resource.id;
  11
  12   if (resource.load) {
  13     var loadPromisified = Promise.method(resource.load);
  14
  15     router.param(idParam, function(req, res, next, id) {
  16       loadPromisified(req, id)
  17         .then(function(value) {
  18           if (value === null || value === undefined) {
  19             throw new StatusError(404);
  20           }
  21
  22           req[idParam] = value;
  23           return null;
  24         })
  25         .nodeify(next);
  26     });
  27   }
  28
  29   function defaultRespond(req, res, responseBody) {
  30     if (responseBody === undefined) {
  31       res.sendStatus(200);
  32     } else {
  33       res.send(responseBody);
  34     }
  35   }
  36
  37   function mount(method, url, methodName) {
  38     var promiseImpl = resource[methodName];
  39     if (!promiseImpl) return;
  40
  41     promiseImpl = Promise.method(promiseImpl).bind(resource);
  42
  43     var responder = resource.respond || defaultRespond;
  44
  45     router[method](url, identifyRoute(routeIdentifier + '-' + methodName), function(
  46       req,
  47       res,
  48       next
  49     ) {
  50       return promiseImpl(req, res)
  51         .then(function(response) {
  52           responder(req, res, response);
  53           return null;
  54         })
  55         .catch(next);
  56     });
  57   }
  58
  59   mount('get', '/', 'index');
  60   mount('get', '/new', 'new'); // TODO: remove this
  61   mount('post', '/', 'create');
  62
  63   mount('put', '/', 'updateRoot');
  64   mount('patch', '/', 'patchRoot');
  65   mount('delete', '/', 'destroyRoot');
  66
  67   if (resource.subresourcesRoot) {
  68     Object.keys(resource.subresourcesRoot).forEach(function(subresourceName) {
  69       var subresource = resource.subresourcesRoot[subresourceName];
  70       router.use(
  71         '/' + subresourceName,
  72         resourceRoute(routeIdentifier + '-' + subresourceName, subresource)
  73       );
  74     });
  75   }
  76
  77   mount('get', '/:' + idParam, 'show');
  78   mount('get', '/:' + idParam + '/edit', 'edit'); // TODO: remove this
  79   mount('put', '/:' + idParam, 'update');
  80   mount('patch', '/:' + idParam, 'patch');
  81   mount('delete', '/:' + idParam, 'destroy');
  82
  83   if (resource.subresources) {
  84     Object.keys(resource.subresources).forEach(function(subresourceName) {
  85       var subresource = resource.subresources[subresourceName];
  86       router.use(
  87         '/:' + idParam + '/' + subresourceName,
  88         resourceRoute(routeIdentifier + '-' + subresourceName, subresource)
  89       );
  90     });
  91   }
  92
  93   return router;
  94 };