active

Features

• high performance
• strict routing
• simple use

Installation

$ npm install active

Quick start

var active = require('active');
var app = active();

app.addRoute({
    'url': '/'
}, function(req, res) {
    res.statusCode = 200;
    res.end(content);
});

app.startServer({
    'port': 80,
    'host': 'localhost',
    'cluster': true
});

Routing

For adding new routing rule, you must use "addRoute" method of application object:

app.addRoute(options, callback);

Options

Settings for special rule.

{
    "method": String, // GET by default, also can be POST, PUT, DELETE
    "url": String, // pattern for request url
    "match": Object, // patterns for special params in request url
    "query": Object // query parameters, after question mark
}

Examples of application routes.

app.addRoute({
    'url': '/{category}',
    'match': {
        'category': ['phones', 'stuff']
    }
}, callback);

app.addRoute({
    'url': '/{category}/{item}',
    'match': {
        'category': ['phones', 'stuff'],
        'item': '([a-z0-9-]{2,63}\.[a-z]{4})'
    }
}, callback);

Callbacks

Helpful information about callbacks.

Request parameters

You can use path parameters, which been set in route ("url" directive):

app.addRoute({
    'url': '/{category}/{item}',
    'match': {
        'category': ['phones', 'stuff'],
        'item': '([a-z0-9-]{2,63}\.[a-z]{4})'
    }
}, function(req, res) {
    console.log(req.params); // {category: String, item: String}
});

Response

You can choose how to return result to the client. Below you can see both examples.

Standart

Use standard capabilities of Node using "res" object:

app.addRoute(route, function(req, res) {
    res.statusCode = 200;
    res.end(content);
});

Custom

Use custom capabilities of framework:

app.addRoute(route, function(req, res) {
    res.html(http_code, html); // show html
});

app.addRoute(route, function(req, res) {
    res.json(http_code, json); // show json
});

Layers

You can add middleware layer for all queries, it can be your own solution or package of other developer. Middleware layer is a function with three arguments: "req", "res" and "next", first and second are standard NodeJS objects, third is callback. Middleware will be executed for every request to the application.

You can use any number of layers, but remember about your rom ;)

app.useLayer(function(req, res, next) {
    next();
});

License

The Active JS framework is open-source software licensed under the MIT