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

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

 

咱們知道Express是一個基於NodeJS的很是優秀的服務端開發框架，本篇CSSer將提供express框架的route和route control章節，route實現了客戶端請求的URL的路徑映射功能，暫且譯爲路由或URL映射吧。若是你仍是不太理解，相信看完本篇文章將會有些收穫的。

路由（URL映射）

Express利用HTTP動做提供了有意義並富有表現力的URL映射API，例如咱們可能想讓用戶賬號的URL看起來像「/user/12」的樣子，下面的例子就能實現這樣的路由，其中與佔位標識符（本例爲:id）相關的值能夠被req.params獲取到。

app.get('/user/:id', function(req, res){
    res.send('user ' + req.params.id);
});

上例中當咱們訪問/user/12時返回「user 12」,CSSer注：app.get至關於在服務器註冊了一個監聽get請求事件的偵聽器，當請求的URL知足第一個參數時，執行後面的回調函數，該過程是異步的。

路由是一個能夠被內部編譯成正則表達式的簡單字符串，好比當/user/:id被編譯後，被內部編譯後的正則表達式字符串看起來會是下面的樣子（簡化後）：

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

要實現複雜點的，咱們能夠傳入正則表達式直接量，由於正則捕獲組是匿名的所以咱們能夠經過req.params進行訪問，第一個捕獲組應該是req.params[0]，第二個應該是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"]

下面是一些路由例子，以及與之相匹配的關聯路徑：

"/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數據，而後利用bodyParser中間件解析json請求體並把json數據返回給客戶端：

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）都沒有任何限制，即用戶能夠傳入各類各樣數據類型的id值，若是咱們但願限制用戶id爲數字，能夠這樣寫「/user/:id(\d+)」，這樣就能保證只有該佔位符數據類型爲數值類型纔會進行路由的相關處理。

路由控制

一個應用中能夠定義多個路由，咱們能夠控制以令其轉向下一個路由，Express提供了第三個參數即next()函數。當一個模式不被匹配時，控制將被轉回Connect（Express基於Connect模塊），同時中間件會繼續按照它們在use()中增長的順序來執行。當多個定義的路由均可能匹配同一個URL時也是如此，除非某個路由並不調用next()且已將響應輸出到客戶端，不然它們也將按順序執行。

app.get('/users/:id?', function(req, res, next){
    var id = req.params.id;
    if (id) {
        // 一回注：若是在這裏就將響應內容輸出給客戶端，那麼後續的URL映射將不會被調用
    } else {
        next(); // 將控制轉向下一個符合URL的路由
    }
});

app.get('/users', function(req, res){
    // do something else
});

app.all()方法能夠對全部HTTP動做應用單一調用入口，這在有些狀況下頗有用。下面咱們使用該功能來從咱們的模擬數據庫中加載一個用戶，並把它分配給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);

路由參數預處理

本節爲後補（2011-4-16）。

路由參數預處理經過隱式的數據處理，能夠大幅提升應用代碼的可讀性和請求URL的驗證。假如你常常性的從幾個路由獲取通用數據，如經過/user/:id加載用戶信息，一般咱們可能會這樣作：

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

利用預處理後參數能夠被映射到回調函數，從而能夠提供諸如驗證、強制性改變值，甚至從數據庫中加載數據等功能。下面咱們將調用app.param()並傳入咱們但願映射到某個中間件的參數，能夠看到咱們接收了包含佔位符（:userId）值的id參數。在這裏能夠與日常同樣進行用戶數據加載以及錯誤處理，並能簡單的經過調用next()將控制權轉向下一個預處理或路由（路徑控制）。

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();
  });
});

這樣作，不只向上面提到的能夠大幅提升路由的可讀性，還能在整個應用中共享該部分的邏輯實現，達到複用目的。

app.get('/user/:userId', function(req, res){
  res.send('CSSer用戶爲 ' + req.user.name);
});

對於簡單的狀況如路由佔位符驗證和強迫改變值，只須要傳入1個參數（支持1個參數），期間拋出的異常將自動傳入next(err)。

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

也能夠同時將回調函數應用到多個佔位符，好比路由/commits/:from-:to來講，:from和:to都是數值類型，咱們能夠將它們定義爲數組：

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

結語

經過本文的學習，咱們應該有些感受了，NodeJS不單單能夠實現咱們產品的服務端邏輯，同時咱們還能夠利用Javascript作服務器編程，注意是服務器，也就是說，咱們能夠利用Javascript來定製以往只能在apache中才能夠作到的功能。NodeJS還須要rewrite嗎？路徑映射更簡單更強大，還要rewrite幹嗎用？