詳解NodeJS框架express的路徑映射（路由）功能及控制

更新時(shí)間：2017年03月24日 10:08:06 作者：youfeng

這篇文章主要介紹了詳解NodeJS框架express的路徑映射（路由）功能及控制，具有一定的參考價(jià)值，感興趣的小伙伴們可以參考一下。

我們知道Express是一個(gè)基于NodeJS的非常優(yōu)秀的服務(wù)端開發(fā)框架，本篇CSSer將提供express框架的route和route control章節(jié)，route實(shí)現(xiàn)了客戶端請(qǐng)求的URL的路徑映射功能，暫且譯為路由或URL映射吧。如果你還是不太理解，相信看完本篇文章將會(huì)有些收獲的。

路由（URL映射）

Express利用HTTP動(dòng)作提供了有意義并富有表現(xiàn)力的URL映射API，例如我們可能想讓用戶帳號(hào)的URL看起來像“/user/12”的樣子，下面的例子就能實(shí)現(xiàn)這樣的路由，其中與占位標(biāo)識(shí)符（本例為:id）相關(guān)的值可以被req.params獲取到。

app.get('/user/:id', function(req, res){

  res.send('user ' + req.params.id);

});

上例中當(dāng)我們?cè)L問/user/12時(shí)返回“user 12”,CSSer注：app.get相當(dāng)于在服務(wù)器注冊(cè)了一個(gè)get請(qǐng)求事件，當(dāng)請(qǐng)求的URL滿足第一個(gè)參數(shù)時(shí)，執(zhí)行后面的回調(diào)函數(shù)，該過程是異步的。

路由是一個(gè)可以被內(nèi)部編譯成正則表達(dá)式的簡單字符串，比如當(dāng)/user/:id被編譯后，被內(nèi)部編譯后的正則表達(dá)式字符串看起來會(huì)是下面的樣子（簡化后）：

復(fù)制代碼代碼如下:

\/user\/([^\/]+)\/?

要實(shí)現(xiàn)復(fù)雜點(diǎn)的，我們可以傳入正則表達(dá)式直接量，因?yàn)檎齽t捕獲組是匿名的因此我們可以通過req.params進(jìn)行訪問，第一個(gè)捕獲組應(yīng)該是req.params[0]，第二個(gè)應(yīng)該是req.params[1]，以此類推。

app.get(/^\/users?(?:\/(\d+)(?:\.\.(\d+))?)?/, function(req, res){

  res.send(req.params);

});

通過Linux的curl命令來測試我們定義的路由：

$ curl http://cssercom:3000/user

[null,null]

$ curl http://cssercom:3000/users

[null,null]

$ curl http://cssercom:3000/users/1

["1",null]

$ curl http://cssercom:3000/users/1..15

["1","15"]

下面是一些路由例子，以及與之相匹配的關(guān)聯(lián)路徑：

"/user/:id"

/user/12

 

"/users/:id?"

/users/5

/users

 

"/files/*"

/files/jquery.js

/files/javascripts/jquery.js

 

"/file/*.*"

/files/jquery.js

/files/javascripts/jquery.js

 

"/user/:id/:operation?"

/user/1

/user/1/edit

 

"/products.:format"

/products.json

/products.xml

 

"/products.:format?"

/products.json

/products.xml

/products

 

"/user/:id.:format?"

/user/12

/user/12.json

另外，我們可以通過POST方式提交json數(shù)據(jù)，然后利用bodyParser中間件解析json請(qǐng)求體并把json數(shù)據(jù)返回給客戶端：

var express = require('express')

 , app = express.createServer();

app.use(express.bodyParser());

app.post('/', function(req, res){

 res.send(req.body);

});

app.listen(3000);

通常我們所使用的占位符（比如/user/:id）都沒有任何限制，即用戶可以傳入各種各樣數(shù)據(jù)類型的id值，如果我們希望限制用戶id為數(shù)字，可以這樣寫“/user/:id(\d+)”，這樣就能保證只有該占位符數(shù)據(jù)類型為數(shù)值類型才會(huì)進(jìn)行路由的相關(guān)處理。

路由控制

一個(gè)應(yīng)用中可以定義多個(gè)路由，我們可以控制以令其轉(zhuǎn)向下一個(gè)路由，Express提供了第三個(gè)參數(shù)即next()函數(shù)。當(dāng)一個(gè)模式不被匹配時(shí)，控制將被轉(zhuǎn)回 Connect（Express基于Connect模塊），同時(shí)中間件會(huì)繼續(xù)按照它們?cè)趗se()中增加的順序來執(zhí)行。當(dāng)多個(gè)定義的路由都可能匹配同一個(gè) URL時(shí)也是如此，除非某個(gè)路由并不調(diào)用next()且已將響應(yīng)輸出到客戶端，否則它們也將按順序執(zhí)行。

app.get('/users/:id?', function(req, res, next){

  var id = req.params.id;

  if (id) {

    // 一回注：如果在這里就將響應(yīng)內(nèi)容輸出給客戶端，那么后續(xù)的URL映射將不會(huì)被調(diào)用

  } else {

    next(); // 將控制轉(zhuǎn)向下一個(gè)符合URL的路由

  }

});

 

app.get('/users', function(req, res){

  // do something else

});

app.all()方法可以對(duì)所有HTTP動(dòng)作應(yīng)用單一調(diào)用入口，這在有些情況下很有用。下面我們使用該功能來從我們的模擬數(shù)據(jù)庫中加載一個(gè)用戶，并把它分配給req.user。

var express = require('express')

 , app = express.createServer(); 

var users = [{ name: 'www.csser.com' }];

app.all('/user/:id/:op?', function(req, res, next){

 req.user = users[req.params.id];

 if (req.user) {

  next();

 } else {

  next(new Error('cannot find user ' + req.params.id));

 }

});

app.get('/user/:id', function(req, res){

 res.send('viewing ' + req.user.name);

});

app.get('/user/:id/edit', function(req, res){

 res.send('editing ' + req.user.name);

}); 

app.put('/user/:id', function(req, res){

 res.send('updating ' + req.user.name);

});

app.get('*', function(req, res){

 res.send('what???', 404);

});
app.listen(3000);

路由參數(shù)預(yù)處理

路由參數(shù)預(yù)處理通過隱式的數(shù)據(jù)處理，可以大幅提高應(yīng)用代碼的可讀性和請(qǐng)求URL的驗(yàn)證。假如你經(jīng)常性的從幾個(gè)路由獲取通用數(shù)據(jù)，如通過/user/:id加載用戶信息，通常我們可能會(huì)這樣做：

app.get('/user/:userId', function(req, res, next){

 User.get(req.params.userId, function(err, user){

  if (err) return next(err);

  res.send('user ' + user.name);

 });

});

利用預(yù)處理后參數(shù)可以被映射到回調(diào)函數(shù)，從而可以提供諸如驗(yàn)證、強(qiáng)制性改變值，甚至從數(shù)據(jù)庫中加載數(shù)據(jù)等功能。下面我們將調(diào)用app.param()并傳入我們希望映射到某個(gè)中間件的參數(shù)，可以看到我們接收了包含占位符（:userId）值的id參數(shù)。在這里可以與平常一樣進(jìn)行用戶數(shù)據(jù)加載以及錯(cuò)誤處理，并能簡單的通過調(diào)用next()將控制權(quán)轉(zhuǎn)向下一個(gè)預(yù)處理或路由（路徑控制）。

app.param('userId', function(req, res, next, id){

 User.get(id, function(err, user){

  if (err) return next(err);

  if (!user) return next(new Error('failed to find user'));

  req.user = user;

  next();

 });

});

這樣做，不僅向上面提到的可以大幅提高路由的可讀性，還能在整個(gè)應(yīng)用共享該部分的邏輯實(shí)現(xiàn)，達(dá)到復(fù)用目的。

app.get('/user/:userId', function(req, res){

 res.send('CSSer用戶為 ' + req.user.name);

});

對(duì)于簡單的情況如路由占位符驗(yàn)證和強(qiáng)迫改變值，只需要傳入1個(gè)參數(shù)（支持1個(gè)參數(shù)），期間拋出的異常將自動(dòng)傳入next(err)。

app.param('number', function(n){ return parseInt(n, 10); });

也可以同時(shí)將回調(diào)函數(shù)應(yīng)用到多個(gè)占位符，比如路由/commits/:from-:to來說，:from和:to都是數(shù)值類型，我們可以將它們定義為數(shù)組：

app.param(['from', 'to'], function(n){ return parseInt(n, 10); });

結(jié)語

通過本文的學(xué)習(xí)，我們應(yīng)該有些感覺了，NodeJS不僅僅可以實(shí)現(xiàn)我們產(chǎn)品的服務(wù)端邏輯，同時(shí)我們還可以利用Javascript做服務(wù)器編程，注意是服務(wù) 器，也就是說，我們可以利用Javascript來定制以往只能在apache中才可以做到的功能。NodeJS還需要rewrite嗎？路徑映射更簡單更強(qiáng)大，還要rewrite干嘛用？

以上就是本文的全部內(nèi)容，希望對(duì)大家的學(xué)習(xí)有所幫助，也希望大家多多支持腳本之家。