express－7 请求和响应对象(2)

获取更多信息

如果正在寻找某些功能，首先要查看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.'});
      }
  });