Pomegranate-Express

A Plugin bundle for the Pomegranate application framework. Pomegranate-Express bundles several easily configurable plugins that implement the Express framework.

Usage and Examples

Install

$ npm install --save pomegranate pomegranate-express
$ ./node_modules/.bin/pomegranate init -f . && ./node_modules/.bin/pomegranate build
$ node pom.js

Routing.

The Router plugin creates your route structure based on directory and module names. You can basically treat it exactly like an instance of Express Router because that is exactly what it is.

ex.

/* file ./routes/index.js */

module.exports = function(Router){

  //available at http://localhost:8080/
  Router.get('/', function(req, res, next){
    res.send('Hello from the index')
  })

  // Note: your route files must return
  // the factory instance of Router provided
  return Router
}

You can define named routes just as easily.

/* file ./routes/hello/index.js */

module.exports = function(Router){
  //available at http://localhost:8080/hello
  Router.get('/', function(req, res, next){
    res.send('Hello from a sub directory')
  })

  //available at http://localhost:8080/hello/world
  Router.get('/world', function(req, res, next){
    res.send('Hello from a named route')
  })
  return Router
}

Finally You can name your files if you have complex routes that you wish to segregate. These coexist with index files, so feel free to experiment with what works best for you.

/* file ./routes/hello/name.js */

module.exports = function(Router){
  //available at http://localhost:8080/hello/name/bob
  Router.get('/:name', function(req, res, next){
    res.send('Hello from a named file ' + req.params.name)
  })
  return Router
}

Middleware.

Obviously any Express application lives on its middleware stack. Pomegranate makes it easy to create, configure and load your middleware functions without a huge boilerplate file.

The Application Plugin creates a shared object that middleware functions can merge into, Later in the Pomegranate bootstrap process, the PreRouter and PostRouter plugins will use this object to mount your middleware. The BundleMiddleware plugin provides some stock functions, but you can easily override them by creating your own with the same name.

ex.

/* file ./plugins/MyMiddleware.js */

module.exports = {
  options: { //optional but preferred}
  metadata: {
    name: 'MyMiddleware',
    layer: 'dependencies'
    param: 'Middleware',
    type: 'merge'
  },
  plugin: {
    load: function(inject, loaded){

      /*
       * Create one or many middleware functions here, you can split them up into separate files if needed.
       */

      var myMiddlewares = {
       awesome: function(req, res, next){
          console.log('You are really awesome')
          next()
       }
     }

     /*
      * When you are ready, call loaded with your middlewares as the second param.
      * If something goes wrong, pass the error to the first param of loaded()
      */

     loaded(null, myMiddlewares)
    },
    start: function(done){
      done(null)
    }
    stop: function(done){
      done(null)
    }
  }
}

Included Plugins

Application

Provides the Express App, Express Router Factory and Middleware object.

Injector: Dynamic Adds a dynamic number of objects.
Injects: Service Express - Configurable instance of Express.
Injects: Factory Router - Provides instances of Express.Router() to define routes on.
Injects: Merge Middleware - An object spanning all of the middleware in a project.
Properties

Name	Type	Default	Description
options	Object		Plugin Options
options.caseSensitiveRoutes	Boolean	false
options.mergeReqParams	Boolean	false
options.strictRouting	Boolean	false

BundledMiddleware

Provides Overrideable standard middleware.

Injector: Merge Merges all returned objects into the provided dep name.
Injects:: function Middleware - 404
Injects:: function Middleware - 500
Properties

Name	Type	Description
options	Object	This plugin has no options

PreMiddleware

Configures the Express application and mounts all pre-route middleware.

Injector: None Adds nothing to the injector.
Properties

Name	Type	Description
options	Object	Plugin Options
options.order	Array	Mount order of middleware functions.

Router

Loads and mounts provided route definition files located in options.workDir

Injector: None Adds nothing to the injector.
Properties

Name	Type	Default	Description
options	Object		Plugin Options
options.workDir	String	./routes	Directory to load routes from.

PostMiddleware

Configures the Express application and mounts all post-route middleware, including error handlers.

Injector: None Adds nothing to the injector.
Properties

Name	Type	Default	Description
options	Object		Plugin Options
options.order	Array.<String>	'['404','500']'	Mount order of middleware functions.

Launcher

Configures the Express application and mounts all pre-route middleware.

Injector: None Adds nothing to the injector.
Properties

Name	Type	Default	Description
options	Object		Plugin Options
options.port	Number	8080	Port to bind server to.
options.address	String	localhost	Address to bind server to.

Bundled Middleware

404

Bundled 404 handler middleware

500