motto - Express 4.x Request对象获得参数方法

---

本文搜索关键字：motto express node js nodejs javascript request body request.body

---

1. req.param()

该方法获得参数最为方便， 可以说是其他三个属性的综合体；但是 express 4.x api文档已写明该方法将会弃用！所以不推荐使用！

该方法的使用如下：

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

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

该方法可以获取：

• express路由器传递的参数;
• 地址栏参数；
• 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);
});

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

4.1.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.1.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); // 123456
    res.json({result: 'success'});
});

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