NodeJS框架express的安装与配置

express是为NodeJS而生的高性能、一流的web开发框架,由于入门指引篇幅较长,本文仅对express框架的安装及配置进行中文翻译,如需原文直接去Express官方网站即可,转载请保留出处,谢谢。

安装

$ npm install express

创建服务器

要创建express.HTTPServer的实例,只需简单的调用createServer()方法即可。通过HTTPServer实例app我们可以定义基于HTTP动作(HTTP verbs)的路径映射(routes),下面的示例中我们定义了app.get()。

var app = require('express').createServer();

app.get('/', function(req, res){
  res.send('hello world from csser.com!');
});

app.listen(3000);

创建HTTPS服务器

要初始化一个express.HTTPSServer,与上例相似,不同的是在createServer方法我们传入一个对象作为配置参数,该对象接受 key, cert 和其它在NodeJS https文档中提到的配置参数。

var app = require('express').createServer({ key: ... });

配置

Express支持多工作环境,比如生产环境和开发环境等。开发者可以使用configure()方法根据当前环境的需要进行设置,当configure()没有传入环境名称时,它会在各环境之前被调用(一回注:相当于被各个环境共享)。

下面的示例我们只抛出异常(dumpException),并且在开发模式对异常堆栈的输出做出响应,但是不论对开发或者生产环境我们都使用了methodOverride和bodyParser。特别注意对app.router的使用,它可以被用来设置应用的路径映射(可选),否则首次对app.get()、app.post()等的调用会设置路径映射。

// 定义共享环境
app.configure(function(){
    app.use(express.methodOverride());
    app.use(express.bodyParser());
    app.use(app.router);
});

// 定义开发环境
app.configure('development', function(){
    app.use(express.static(__dirname + '/public'));
    app.use(express.errorHandler({ dumpExceptions: true, showStack: true }));
});

// 定义生产环境
app.configure('production', function(){
    var oneYear = 31557600000;
    app.use(express.static(__dirname + '/public', { maxAge: oneYear }));
    app.use(express.errorHandler());
});

对于内部和多重设置(internal和arbitrary),Express提供了 set(key[, val]), enable(key), disable(key)等方法:

app.configure(function(){
   app.set('views', __dirname + '/views');
   app.set('views');
   // => "/absolute/path/to/views"

   app.enable('some feature');
   // 与 app.set('some feature', true); 相同

   app.disable('some feature');
   // 与 app.set('some feature', false); 相同

   app.enabled('some feature')
   // => false
});

要修改环境,可以通过设置NODE_ENV环境变量来实现,例如:

$ NODE_ENV=production node app.js

这很重要,因为许多的缓存机制只有在生产环境才会启用。

设置

Express 支持以下设置项:

home 为res.redirect()提供应用的基准路径,透明的处理已安装的应用。

views视图(views)层的根目录,默认指向CWD/views

viewengine默认的视图(view)引擎的名字,不包含扩展名。

viewoptions用于设置全局视图选项的对象

相关推荐