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);
     // 123456
     });

ps: 若是post給後臺沒有傳遞任何參數時， req.body的值固然也是空對象{}

參考文檔：

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