获取更多信息###
如果正在寻找某些功能,首先要查看Express的API文档
如果需要的信息没在文档中,有时就不得不深入研究Express源码; 下面是Express源码的路径说明
lib/application.js
Express主接口。如果想了解中间件是如何接入的,或视图是如何被渲染的,可以看这里。lib/express.js
这是一个相对较短的shell,是lib/application.js中Connect的功能性扩展,它返回一个函数,可以用http.createServer
运行Express应用。lib/request.js
扩展了Node的http.IncomingMessage
对象,提供了一个稳健的请求对象。关于请求对象属性和方法的所有信息都在这个文件里。lib/response.js
扩展了Node的http.ServerReponse
对象,提供响应对象。关于响应对象的所有属性和方法都在这个文件里。lib/router/route.js
提供基础路由支持。尽管路由是应用的核心,但这个文件只有不到200行,你会发现它非常地简单优雅。在你深入研究Express源码时,或许需要参考Node文档,尤其是HTTP模块部分;
内容渲染###
大多数情况下,渲染内容用res.render,它最大程度地根据布局渲染视图。如果想写一个快速测试页,也许会用到res.send
。你可以使用req.query
得到查询字符串的值,使用req.session
得到会话值,或使用req.cookie/req.singedCookies
得到cookies值。
- 基本用法
//基本用法
app.get('/about', function(req, res){
res.render('about');
});
- 200以外的响应代码
app.get('/error', function(req, res){
res.status(500);
res.render('error');
});
//或是一行...
app.get('/error', function(req, res){
res.status(500).render('error');
});
- 将上下文传递给视图,包括查询字符串、cookie和session值
app.get('/greeting', function(req, res){
res.render('about', {
message: 'welcome',
style: req.query.style,
userid: req.cookie.userid,
username: req.session.username,
});
});
- 没有布局的视图渲染
//下面的layout没有布局文件,即views/no-layout.handlebars
//必须包含必要的HTML
app.get('/no-layout', function(req, res){
res.render('no-layout', { layout: null });
});
- 使用定制布局渲染视图
// 使用布局文件views/layouts/custom.handlebars
app.get('/custom-layout', function(req, res){
res.render('custom-layout', { layout: 'custom' });
});
- 渲染纯文本输出
app.get('/test', function(req, res){
res.type('text/plain');
res.send('this is a test');
});
- 添加错误处理程序
//这应该出现在所有路由方法的结尾
//需要注意的是,即使你不需要一个“下一步”方法
//它也必须包含,以便Express将它识别为一个错误处理程序
app.use(function(err, req, res, next){
console.error(err.stack);
res.status(500).render('error');
});
- 添加一个404处理程序
//这应该出现在所有路由方法的结尾
app.use(function(req, res){
res.status(404).render('not-found');
});
处理表单###
当处理表单时,表单信息一般在req.body
中(或者偶尔在req.query
中)。可以使用req.xhr
来判断是AJAX请求还是浏览请求
- 基本表单处理
//必须引入中间件body-parser
app.post('/process-contact', function(req, res){
console.log('Received contact from ' + req.body.name +
' <' + req.body.email + '>');
//保存到数据库....
res.redirect(303, '/thank-you');
});
- 更强大的表单处理
//必须引入中间件body-parser
app.post('/process-contact', function(req, res){
console.log('Received contact from ' + req.body.name +
' <' + req.body.email + '>');
try {
//保存到数据库....
return res.xhr ?
res.render({ success: true }) :
res.redirect(303, '/thank-you');
} catch(ex) {
return res.xhr ?
res.json({ error: 'Database error.' }) :
res.redirect(303, '/database-error');
}
});
提供一个API###
如果提供一个类似于表单处理的API,参数通常会在req.query
中,虽然也可以使用req.body
。与其他API不同,这种情况下通常会返回JSON、XML或纯文本,而不是HTML。你会经常使用不太常见的HTTP方法,比如PUT、POST和DELETE。
- “产品”数组(通常是从数据库中检索):
var tours = [
{ id: 0, name: 'Hood River', price: 99.99 },
{ id: 1, name: 'Oregon Coast', price: 149.95 },
];
- 简单的GET节点,只返回JSON数据
app.get('/api/tours'), function(req, res){
res.json(tours);
});
- 根据客户端的首选项,使用Express中的res.format方法对其响应。GET节点,返回JSON、XML或text
app.get('/api/tours', function(req, res){
var toursXml = '<?xml version="1.0"?><tours>' +
products.map(function(p){
return '<tour price="' + p.price +
'" id="' + p.id + '">' + p.name + '</tour>';
}).join('') + '</tours>'';
var toursText = tours.map(function(p){
return p.id + ': ' + p.name + ' (' + p.price + ')';
}).join('\n');
res.format({
'application/json': function(){
res.json(tours);
},
'application/xml': function(){
res.type('application/xml');
res.send(toursXml);
},
'text/xml': function(){
res.type('text/xml');
res.send(toursXml);
}
'text/plain': function(){
res.type('text/plain');
res.send(toursXml);
}
});
});
- PUT节点更新一个产品信息然后返回JSON。参数在查询字符串中传递(路由字符串中的'':id''命令Express在
req.params
中增加一个id属性)。用于更新的PUT节点
//API用于更新一条数据并且返回JSON;参数在查询字符串中传递
app.put('/api/tour/:id', function(req, res){
var p = tours.some(function(p){ return p.id == req.params.id });
if( p ) {
if( req.query.name ) p.name = req.query.name;
if( req.query.price ) p.price = req.query.price;
res.json({success: true});
} else {
res.json({error: 'No such tour exists.'});
}
});
- 用于删除的DEL节点
// API用于删除一个产品
api.del('/api/tour/:id', function(req, res){
var i;
for( var i=tours.length-1; i>=0; i-- )
if( tours[i].id == req.params.id ) break;
if( i>=0 ) {
tours.splice(i, 1);
res.json({success: true});
} else {
res.json({error: 'No such tour exists.'});
}
});