Node.js:Express 入門和基礎知識

Express 是一個自身功能極簡,完全是由路由和中間件構成一個的 web 開發框架:從本質上來說,一個 Express 應用就是在調用各種中間件。

初始化

新建一個目錄myapp,項目初始化

$ npm init

安裝express

$ npm install express --save

創建一個hello world實例

進入myapp目錄,創建一個名爲app.js,複製以下代碼

var express = require('express');
var app = express();

app.get('/', function (req, res) {
  res.send('Hello World!');
});

var server = app.listen(3000, function () {
  var host = server.address().address;
  var port = server.address().port;

  console.log('Example app listening at http://%s:%s', host, port);
});

上面的代碼啓動一個服務並監聽從 3000 端口進入的所有連接請求。他將對所有 (/) URL 或 路由 返回 “Hello World!” 字符串。對於其他所有路徑全部返回 404 Not Found。

通過以下命令行啓動

$ node app.js

然後在瀏覽器中打開 http://localhost:3000/ 並查看輸出結果。

express生成器

通過應用生成器工具 express 可以快速創建一個應用的骨架。

1.安裝以下命令

//code from http://caibaojian.com/express-basic.html
$ npm install express-generator -g

2.在當前目錄創建myapp的應用,運行以下命令·

$ express myapp
$ cd myapp 
$ npm install
> set DEBUG=myapp & npm start

然後在瀏覽器中打開 http://localhost:3000/ 網址就可以看到這個應用了。

通過 Express 應用生成器創建的應用一般都有如下目錄結構:

.
├── app.js
├── bin
│   └── www
├── package.json
├── public
│   ├── images
│   ├── javascripts
│   └── stylesheets
│       └── style.css
├── routes
│   ├── index.js
│   └── users.js
└── views
    ├── error.jade
    ├── index.jade
    └── layout.jade

7 directories, 9 files

express路由

路由(Routing)是由一個 URI(或者叫路徑)和一個特定的 HTTP 方法(GET、POST 等)組成的,涉及到應用如何響應客戶端對某個網站節點的訪問。每一個路由都可以有一個或者多個處理器函數,當匹配到路由時,這個/些函數將被執行。

路由的定義由如下結構組成:app.METHOD(PATH, HANDLER)。其中,app 是一個 express 實例;METHOD 是某個 HTTP 請求方式中的一個;PATH 是服務器端的路徑;HANDLER 是當路由匹配到時需要執行的函數。

以下是一些常見的路由代碼

var express = require('express');
var app = express();

// respond with "hello world" when a GET request is made to the homepage
app.get('/', function(req, res) {
  res.send('hello world');
});

// POST method route
app.post('/', function (req, res) {
  res.send('POST request to the homepage');
});
//app.all() 是一個特殊的路由方法,沒有任何 HTTP 方法與其對應,它的作用是對於一個路徑上的所有請求加載中間件。
app.all('/secret', function (req, res, next) {
  console.log('Accessing the secret section ...');
  next(); // pass control to the next handler
});

使用字符串模式的路由路徑示例:字符 ?、+、* 和 () 是正則表達式的子集,- 和 . 在基於字符串的路徑中按照字面值解釋。

// 匹配 acd 和 abcd
app.get('/ab?cd', function(req, res) {
  res.send('ab?cd');
});

// 匹配 abcd、abbcd、abbbcd等
app.get('/ab+cd', function(req, res) {
  res.send('ab+cd');
});

// 匹配 abcd、abxcd、abRABDOMcd、ab123cd等
app.get('/ab*cd', function(req, res) {
  res.send('ab*cd');
});

// 匹配 /abe 和 /abcde
app.get('/ab(cd)?e', function(req, res) {
 res.send('ab(cd)?e');
});

//使用正則表達式的路由路徑示例:
// 匹配任何路徑中含有 a 的路徑:
app.get(/a/, function(req, res) {
  res.send('/a/');
});

// 匹配 butterfly、dragonfly,不匹配 butterflyman、dragonfly man等
app.get(/.*fly$/, function(req, res) {
  res.send('/.*fly$/');
});

路由句柄

可以爲請求處理提供多個回調函數,其行爲類似 中間件。唯一的區別是這些回調函數有可能調用 next('route') 方法而略過其他路由回調函數。

路由句柄有多種形式,可以是一個函數、一個函數數組,或者是兩者混合,如下所示

//使用多個回調函數處理路由(記得指定 next 對象):
app.get('/example/b', function (req, res, next) {
  console.log('response will be sent by the next function ...');
  next();
}, function (req, res) {
  res.send('Hello from B!');
});

//使用回調函數數組處理路由:

var cb0 = function (req, res, next) {
  console.log('CB0');
  next();
}

var cb1 = function (req, res, next) {
  console.log('CB1');
  next();
}

var cb2 = function (req, res) {
  res.send('Hello from C!');
}

app.get('/example/c', [cb0, cb1, cb2]);

響應方法

下表中響應對象(res)的方法向客戶端返回響應,終結請求響應的循環。如果在路由句柄中一個方法也不調用,來自客戶端的請求會一直掛起。

方法 描述
res.download() 提示下載文件。
res.end() 終結響應處理流程。
res.JSON() 發送一個 JSON 格式的響應。
res.jsonp() 發送一個支持 JSONP 的 JSON 格式的響應。
res.redirect() 重定向請求。
res.render() 渲染視圖模板。
res.send() 發送各種類型的響應。
res.sendFile 以八位字節流的形式發送文件。
res.sendStatus() 設置響應狀態代碼,並將其以字符串形式作爲響應體的一部分發送。

app.route()

可使用 app.route() 創建路由路徑的鏈式路由句柄。由於路徑在一個地方指定,這樣做有助於創建模塊化的路由,而且減少了代碼冗餘和拼寫錯誤。

app.route('/book')
  .get(function(req, res) {
    res.send('Get a random book');
  })
  .post(function(req, res) {
    res.send('Add a book');
  })
  .put(function(req, res) {
    res.send('Update the book');
  });

express.Router

可使用 express.Router 類創建模塊化、可掛載的路由句柄。Router 實例是一個完整的中間件和路由系統,因此常稱其爲一個 “mini-app”。

在 app 目錄下創建名爲 birds.js 的文件,內容如下:

var express = require('express');
var router = express.Router();

// 該路由使用的中間件
router.use(function timeLog(req, res, next) {
  console.log('Time: ', Date.now());
  next();
});
// 定義網站主頁的路由
router.get('/', function(req, res) {
  res.send('Birds home page');
});
// 定義 about 頁面的路由
router.get('/about', function(req, res) {
  res.send('About birds');
});

module.exports = router;

然後在應用中加載路由模塊:

var birds = require('./birds');
...
app.use('/birds', birds);

應用即可處理髮自 /birds 和 /birds/about 的請求,並且調用爲該路由指定的 timeLog 中間件。

利用 Express 託管靜態文件

通過 Express 內置的 express.static 可以方便地託管靜態文件,例如圖片、CSSJavaScript 文件等。

將靜態資源文件所在的目錄作爲參數傳遞給 express.static 中間件就可以提供靜態資源文件的訪問了。例如,假設在 public 目錄放置了圖片、CSS 和 JavaScript 文件,你就可以:

app.use(express.static('public'));

現在,public 目錄下面的文件就可以訪問了。

http://localhost:3000/images/kitten.jpg
http://localhost:3000/css/style.css
http://localhost:3000/js/app.js
http://localhost:3000/images/bg.png
http://localhost:3000/hello.html

如果你的靜態資源存放在多個目錄下面,你可以多次調用 express.static 中間件:

app.use(express.static('public'));
app.use(express.static('files'));

如果你希望所有通過 express.static 訪問的文件都存放在一個“虛擬(virtual)”目錄(即目錄根本不存在)下面,可以通過爲靜態資源目錄指定一個掛載路徑的方式來實現,如下所示:

app.use('/static', express.static('public'));

現在,你就愛可以通過帶有 “/static” 前綴的地址來訪問 public 目錄下面的文件了。

http://localhost:3000/static/images/kitten.jpg
http://localhost:3000/static/css/style.css
http://localhost:3000/static/js/app.js
http://localhost:3000/static/images/bg.png
http://localhost:3000/static/hello.html

常見問題

如何處理 404 ?

在 Express 中,404 並不是一個錯誤(error)。因此,錯誤處理器中間件並不捕獲 404。這是因爲 404 只是意味着某些功能沒有實現。也就是說,Express 執行了所有中間件、路由之後還是沒有獲取到任何輸出。你所需要做的就是在其所有他中間件的後面添加一個處理 404 的中間件。如下:

app.use(function(req, res, next) {
  res.status(404).send('Sorry cant find that!');
});

Express 支持哪些模板引擎?

Express 支持任何符合 (path, locals, callback) 接口規範的模板引擎。具體可看這個項目:https://github.com/tj/consolidate.js

如何渲染純 HTML 文件?

不需要!無需通過 res.render() 渲染 HTML。你可以通過 res.sendFile() 直接對外輸出 HTML 文件。如果你需要對外提供的資源文件很多,可以使用 express.static() 中間件。

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章