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

 

ps: 如果post給后台沒有傳遞任何參數時， req.body的值當然也是空對象{}

 

 

 

 

參考文檔：

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