Express Bootstrap

Bootstrap for Node.js express web applications.

Know before start

Before you begin to develop, make sure you have known something about these:

JavaScript
node API
Express: node.js web application framework
Sequelize: node.js database ORM middleware
MySQL
Heroku: this sample is held on Heroku PaaS
mustache (Hogan, Handlebars): logic-less template engine

Local deployment

You need run these steps just once.

First, you need to use npm install to download all depended pacakges.

$ npm install
$ sudo npm install -g nodemon   # nodemon is only for development

Copy .env.sample to .env, and configure your database URL in it, also set local HTTP port you like. The db_protocol could be mysql or postgres or any other your are using.
Use this command to initilize database tables (make sure you've installed MySQL or Postgresql):
```
$ node install
```
Start app by this command:
```
$ node app
```

Architecture

Folder structure

.
|-- assets/           # Static files, including JS, CSS, images
|-- controllers/      # All HTTP API routers, same path as folder
|-- filters/          # Interceptor filters before routers
|-- lib/              # Local library for application
|-- store/            # Database definition
|  |-- mysql/         # Sequelize MySQL table definition
|  |-- postgres/      # Sequelize Postgresql table definition
|  `-- ...            # Other database driver definition
|-- views/            # Templates
|-- .env.sample       # Local environment config sample
|-- .gitignore        #
|-- app.js            # Application main file
|-- config.json       # Application config
|-- package.json      # Node package config
|-- Procfile          # Heroku startup command file
`-- README.md         #

Back end MVC

Model

All models are about database tables, and use Sequelize ORM framework to manage them in store/<db driver>/ folder.

Every file in store/<db driver>/ folder defined a database table, use camel case table name, excluding a special file index.js which maintains all tables associations (1 to 1, 1 to many, many to many) in it.

Controller(action)

Just like Action layer in Java SSH, or controller in PHP CI, here controllers' responsibility as routing and catching HTTP request from client.

All files under controllers/ folder would have same path when client request. For example, controllers/index.js would catch request from http://yourhost/, controllers/account/login.js would catch request from http://yourhost/account/login.

In order to do some pre-treatment before real action process, there designed a filter layer just like interceptors in Java SSH. And it is easy to maintain in filters/ folder. Every filter is a Express request handling router, which can be use as real routers but not. Filter should exports a function, with parameters request, response and next.

If a controller need to be intercepted by some filters, it should be define like this:

// real controller process
module.get = function (req, res, next) {
	// ...
	res.send(200, 'OK');
};

// filters which have same name in `filters/` folder
// if defined, must be an Array
module.get.filters = ['authorization'];

And if an action don't need filters, the controller definition just exports a process function is also ok.

All controllers routing had been move to a single npm. See more about Rainbow.

View (template engine)

Use MustLayout to configurate express view engine. Default to:

Views: /views
Partials: /views/partials
Layouts: /views/layouts
Cache: /views/cache
Tempalte extname: .tpl
View engine: Hogan

All these configuration could be changed in app.js.

RESTful HTTP Response

Here is some HTTP status code used for certain meaning of response from server. And the methods in this list have been implemented in response object.

200 data

Everything is OK, and responese contains some data from server.
201(*) created

Create done, and response new created resources.

May use for creating new data record.
204 ok

A certain operation has been done successfully, and no extra data need to response.

Used for updating or deleting some data.
205(*) done

Almost same as 204, but need to update view.

May use in login/logout, etc.
400 badrequest

Syntax error.

Query parameters less than required or data type not match.
403 forbidden

Forbidden. Just indicates that the request need authorization.
404 notfound

Not found. Wrong path or resouces not exist (may be private).
409 conflict

Confict. Repeat record.
422(*) wrongcontent

Semantics error.

Something like 400, additionally indicates query parameters contains wrong content.
500 servererror

Server error. There is something wrong in server.

Mostly indicates that server exceptions have not been caught.

These all could be used in both filters and controllers.

Notice: * means it is just in design.

For more infomation wiki:HTTP status codes.

-EOF-

eeyoo/express-bootstrap