nodify-approute v1.0.0

nodify-approute

Connect.js middleware to automagically convert HTTP requests into "live" JavaScript objects, route them to appropriate functions, then wrap their responses into HTTP responses. Developers worry about the content of API requests, not administrivia of converting to/from HTTP responses/requests.

Installation

The easiest way to install this package is to use npm:

If you want to check out the source, use the git command:

Usage

Initialization

nodify-approute is initialized by passing a route descriptor to the createInstance() and then call the init function on the instance, passing a callback function like this:

There are two things you should note about this example:

• I totally punted on giving a route descriptor (that's cause they tend to be complicated.
• nodify-approute doesn't do much unless you're using it in conjunction with connect.js (or express.js)

Route Descriptors

Route Descriptors contain arrays of objects describing a route and "method functions" to execute when requests are received by the connect server. Here's an example:

This descriptor defines three routes: "/", "/login" and "/session/+". Assuming you called the connect.js use() function with "/app" as the first parameter (and thus making all routes relative to the "/app" path) executing a HTTP GET at "/app/" would cause the topmost get: function to execute.

Note that the "/session/+" route includes a regex group; this defines a parameter. Routes with parameters use the params array in the descriptor to give names to parameters.

Parameters can be validated by defining a validate() function. The function is called with a parameters object and a callback. Calling the callback with a boolean tells nodify-approute whether or not the parameters are valid.