express4.x Request对象获得参数方法小谈【原创】

　　最近看完慕课网 “node.js 建站攻略”后， 对mongodb 操作有了进一步认识， 为了进一步巩固该数据库知识, 于是使用学到的知识搭建一个最简单的mongoDemo.

搭建完成后已放到Github分享， 详情请戳 mongoDemo源码 感兴趣的小伙伴可以看看；回到主题， 完成该小项目后对nodejs后台开发有了一些小悟，本文就req最常用的参数获取做个小结；

　　node.js后台开发基本都会碰到使用 req.param()、req.params 、 req.query、 req.body获取参数的情况， 那么它们有哪些区别呢？以下详细分析之：

1. req.param()

该方法获得参数最为方便， 可以说是其他三个属性的综合体；但是 express 4.x api文档已写明该方法将会弃用！今后只能改用其他三个req属性获取参数。(Ps: 鄙人express4.x项目使用req.param()时不会报错，但启动项目时会有警告提示)

该方法的使用如下：

// /user/tobi for /user/:name
req.param('name')
// => "tobi"

// ?name=tobi
req.param('name')
// => "tobi"

// POST name=tobi
req.param('name')
// => "tobi"

该方法可以获取

1）express路由器传递的参数;

2）地址栏参数；

3）postt提交的参数，例如表单中input的值， ajax（异步）提交的对象值等。

2.req.params

　　与req.param()方法相比 该属性只能获取 “express路由器传递的参数”,  值得一提的是： 与req.params配合还能在express路由器中玩正则。

先看下简单的req.params 使用：

// GET /user/tj
req.params.name
// => "tj"

完整代码中是这样的：

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

// 地址栏： localhost:3000/user/tj
app.get('/user/:name', function(req, res){
  var param = req.params.name
  res.send('hello world' + param); // hello world tj
});

然后看看路由器中神奇的正则使用法,在地址栏输入 localhost:3000/file/javascripts/jquery.js , 而路由中设置了 “/file/*”  时:

// GET /file/javascripts/jquery.js
req.params[0]
// => "javascripts/jquery.js"

完整代码：

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

// 地址栏：localhost:3000/file/javascripts/jquery.js
app.get('/file/*', function(req, res){
  var param = req.params[0];
  res.send(param); //javascripts/jquery.js
});

ps: 如果没在路由器设置参数， 则 req.params 获得的值为空对象 {}

3.req.query

　　该属性用法最为简单， 直接获取地址栏传递的参数；示例代码如下：

// GET /search?q=tobi+ferret
req.query.q
// => "tobi ferret"

// GET /shoes?order=desc&shoe[color]=blue&shoe[type]=converse
req.query.order
// => "desc"

req.query.shoe.color
// => "blue"

req.query.shoe.type
// => "converse"

完整代码：

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

// 地址栏： localhost:3000/search?q=tobi+ferret
app.get('/search', function(req, res){
  var param = req.query.q;
  res.send(param);       //tobi ferret
});

// 地址栏： localhost:3000/shoes?order=desc&shoe[color]=blue&shoe[type]=converse
app.get('/shoes', function(req, res){
  var _order = req.query.order;
  var _color = req.query.shoe.color;
  var _type = req.query.shoe.type;
  console.log(_order);  // desc
  console.log(_color);   // blue
  console.log(_type);   // converse
  res.send('hello world');
});

ps: 如果地址栏没传递参数， req.query获得的值也是空对象{}

4. req.body

　　该属性主要用与post方法时传递参数使用， 用法最为广泛也最为常见， 例子也比较多（写这部分最累了有木有）。需要说明下的是使用该属性时， 得先确认app.js中有没有导入“body-parser”， 该模块在express4.x中已经脱离为独立的模块。示例代码如下：

var app = require('express')();
var bodyParser = require('body-parser');
var multer = require('multer'); 

app.use(bodyParser.json()); // for parsing application/json
app.use(bodyParser.urlencoded({ extended: true })); // for parsing application/x-www-form-urlencoded
app.use(multer()); // for parsing multipart/form-data

app.post('/', function (req, res) {
  console.log(req.body);
  res.json(req.body);
})

最常使用req.body的场合有：

4-1 表单post传递参数至后台：

　　网站中经常用表单传递参数给后台， 在express4.x中使用req.body接收参数， 完整代码如下：

  <form method="POST" action="add" name="userform" >
     <input type="text" id="name" name="name" value="xq" class="form-control" />
     <input type="text" id="age" name="age" value="12" class="form-control" />
     <input type="text" id="job" name="job" value="coder" class="form-control" />
     <input type="text" id="hobby" name="hobby" value="run" class="form-control" />
     <button type="submit" class="btn btn-primary">提交添加</button>
  </form>

var express = require('express');
var router = express.Router();

router.route('/add').post(function(req, res){
  var userObj = {};
  userObj = {
    name: req.body.name,
    age: req.body.age,
    job: req.body.job,
    hobby: req.body.hobby
  };
  console.log(userObj);  // {name:'xq',age:'12',job:'coder',hobby:'run'}
});

4-2 jquery ajax传递参数至后台：

　　网站开发当然少不了使用异步传递参数给后台， express4.x中也是以req.body接收异步传递的参数， 完整代码如下：

var _id = '123456';
$.post('/user/delete', {id: _id}, function(data){
    if (data.error){
       $('#removeTips').html('删除异常:' + data.error + '  请刷新重试。');
    }else{
       window.location.href = '/admin/';
    }
 }, 'json');

var express = require('express');
var router = express.Router();
router.route('/user/delete').post(function(req, res){
    var _id = req.body.id;
    console.log(_id); //
    res.json({result: 'success'});
});

ps: 如果post给后台没有传递任何参数时， req.body的值当然也是空对象{}

参考文档：

http://expressjs.com/api.html#request