Advanced

A simple MVC framework based on Express

Install

npm install advanced -g

Create an application

# create demo
advanced new app
# install app
cd app
npm install
# start app
node server.js

Visit http://localhost:8586

Create a controller

Controllers are placed in app/controllers.

For example app/controllers/test.js:

var Controller = require('advanced').Controller;

module.exports = Controller.extend({
    index: function() {
        this.res.send('Hello World!');
    }
});

Visit http://localhost:8586/test

Router

Router inherits Router of Express. But there are some enhanced features.

Custom router

You can use a string to specify a controller and a method. i.e. controller@method

In app/routes.js

var Router = require('advanced').Router,
    router = Router();

// a string to specify a controller and a method. i.e. controller@method
router.get('/test/add/:id(\\d+)', 'test@addTest');

module.exports = router;

Specify routes with group. It likes router.use. The difference is that you don't need to create a router manually.

var Router = require('advanced').Router,
    router = Router();

router.group('/group', function(router) {
    router.get('/a', 'test@a'); // /group/a
    router.get('/b', 'test@b'); // /group/b
}

module.exports = router;

Default router

A simple router based on file of controller is supported.

If doesn't match any custom router, it will go here.

For example:

req.path = '/this/is/a/path'

is exists /this/is/a/path/index.js@index
is exists /this/is/a/path.js@index
is exists /this/is/a.js@path
is exists /this/is.js@a, this.req.params[0] = 'path'

Mock data

If set env = 'development' and isMock = true in config.js, it will load the middleware of mock. The request which created by invoking Cotroller::request method will be mocked.

For example. Assume that the request path is /test/api. If there is a json file whose path is /mock/test/api.json, the json data will be sent by reading the file.

Debug template data

Add debug=true to query string. When you want render a template, in development mode, it will output json data that will be rendered to the template.

For example: Visit http://127.0.0.1:8586/?debug=true will get

{
    "test": 1
}

Create http request in node

This method uses request module.

Call Controller::request to create a request in node. A promise will be returned. The arguments pass to the function like below.

The baseUrl is Utils.c('api.defaults') which is assigned to this._api

{
    dataKey1: '/path1',
    datakey2: '/path2'
}

The data returned likes below.

{
    dataKey1: {...},
    dataKey2: {...}
}

The response data will be assigned to the corresponding key totally. But you can filter the response data by overriding the _filerData method.

module.exports = Controller.extend({
    _filterData: function(data) {
        return data.data;
    },

    index: function() {
        this.request({
            dataKey1: '/path1',
            datakey2: '/path2'
        }).then(function(data) {
            this.render('index.swig', data);
        }.bind(this));
    }
})

You can pass data to destination when you create a request. Any options that can be passed to request module also can be passed to request method.

qs object containing querystring values to be appended to the uri
form object to be passed to destination like to submit a form.

For example:

module.exports = Controller.extend({
    index: function() {
        this.request({
            dataKey1: {
                uri: '/path1',
                qs: {
                    name: 'Javey'
                },
                form: {
                    password: '123'
                }
            },
            datakey2: '/path2'
        }).then(function(data) {
            this.render('index.swig', data);
        }.bind(this));
    }
})

Api Proxy

Utils.proxy(req, res, host)

You don't need to do anything, When you want to forward a request(req). The apiProxy middleware can do anything for you. It can forward a request which is created by AJAX to the host server transparently.

Config

Config file is placed in config/. If the filename starts with config, it will be loaded automatically.

Utils.c(key, [value])

@param key {String|Object}
@param value {*}
@return {*} The config you get or set.

Set config

Use Utils.c(key, value) to set config. The key can be a object, if you want set a block of config. If the value depends the other one. You can specify it like below:

var conf = {
    a: 'a',
    ab: '{a}b' // ab depends a
}
Utils.c(conf);

Get config

Use Utils.c(key) to get config. The key is a string.

Utils.c('ab'); // the value is 'ab'

License

MIT

Javey/advanced