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用于设置全局视图选项的对象