Express 是老牌的 Node.js 框架，以簡單和輕量著稱，幾行代碼就可以啟動一個(gè) HTTP 服務(wù)器。市面上主流的 Node.js 框架，如 Egg.js、Nest.js 等都與 Express 息息相關(guān)。
Express 框架使用標(biāo)準(zhǔn) Node.js 語法，主要由以下 3 個(gè)核心部分組成：
- 路由。
- 中間件。
- 錯(cuò)誤處理。
認(rèn)識基本結(jié)構(gòu)
Express 的基本結(jié)構(gòu)很簡單，只需要三行代碼，應(yīng)用就可以運(yùn)行起來。
const express = require('express')
const App = express()
app.listen(9000, () => console.log('啟動成功'))
假設(shè)上述代碼寫在 index.js 中，我們啟動該應(yīng)用使用命令 node ./index.js，控制臺會輸出“啟動成功”。
為了方便，我們也可以在 package.json 中創(chuàng)建快捷命令，如下：
// package.json
{
"scripts": {
"start": "node ./index.js"
}
}
那么現(xiàn)在啟動應(yīng)用就可以用 npm run start 命令。
不過這種方式在本地運(yùn)行項(xiàng)目時(shí)會有一個(gè)弊端，就是修改文件后不會立即生效，需要重新啟動。為了提高效率，一般會使用一個(gè)名為 PM2 的模塊啟動 Node.js 應(yīng)用。
首先全局安裝 pm2：
$ npm install -g pm2
安裝后在項(xiàng)目目錄下創(chuàng)建啟動配置文件 ecosystem.config.js，代碼如下：
module.exports = {
apps: [
{
name: 'first-api',
script: './index.js',
},
],
}
然后在項(xiàng)目目錄下執(zhí)行以下命令就可以啟動項(xiàng)目了：
$ pm2 start --watch
上圖中的 0 就是啟動應(yīng)用的 ID，下面會用到。
PM2 常用大命令如下：
- pm2 start：啟動應(yīng)用，--watch 表示監(jiān)聽文件修改自動重啟。
- pm2 list：查看已啟動的應(yīng)用列表。
- pm2 logs <id>：查看日志輸出。
- pm2 delete <id>：刪除指定應(yīng)用。
應(yīng)用啟動后監(jiān)聽 9000 端口，但訪問 “http://localhost:9000” 卻沒有反應(yīng)，請求被掛起，這是因?yàn)闆]有設(shè)置如何處理請求。
Express 中通過定義路由來處理請求。
使用路由創(chuàng)建 API 接口
路由用于定義如何處理請求，定義方式采用以下結(jié)構(gòu)：
app.METHOD(PATH, HANDLER)
其中 app 表示 Express 的實(shí)例，其余的三個(gè)部分都屬于路由配置，表示的含義如下：
- METHOD：路由方法。
- PATH：路由地址。
- HANDLER：路由處理函數(shù)。
比如示例代碼中的路由是這樣子：
app.get('/', (req, res) => {
res.send('Hello World')
})
使用app.get()定義了一個(gè) GET 請求的路由，第一個(gè)參數(shù) “/” 為路由地址，第二個(gè)參數(shù)為路由處理函數(shù)，是一個(gè)回調(diào)函數(shù)，該函數(shù)接受兩個(gè)參數(shù)分別表示請求和響應(yīng)。
當(dāng)路由方法和路由地址匹配到用戶請求時(shí)，路由處理函數(shù)就會執(zhí)行。
路由方法根據(jù)基本 API 規(guī)則支持五種，分別如下：
- app.get()：GET 請求。
- app.post()：POST 請求。
- app.put()：PUT 請求。
- app.delete()：DELETE 請求。
- app.all()：匹配所有請求。
以上五個(gè)方法的參數(shù)都與示例路由一致。定義好路由后，我們的主要任務(wù)是在路由處理函數(shù)中編寫業(yè)務(wù)代碼，一般會包括接收請求參數(shù)、返回接口響應(yīng)，這里要用到路由處理函數(shù)的兩個(gè)參數(shù)。
請求對象
路由處理函數(shù)的第一個(gè)參數(shù)表示請求對象，包含客戶端請求攜帶的相關(guān)數(shù)據(jù)，常用的屬性如下：
- req.query：URL 附加參數(shù)。
- req.body：請求體參數(shù)。
- req.method：請求方法。
- req.headers：請求頭對象。
- req.params：URL 地址參數(shù)。
現(xiàn)在我們定義一個(gè)路由，將請求對象的這幾個(gè)屬性返回，看一下它們的值是什么：
app.post('/first/:id', (req, res) => {
let { method, query, body, params, headers } = req
res.send({ method, query, body, params, headers })
})
在 Postman 中請求地址 “http://localhost:9000/first/8?tag=test” 并傳入請求體參數(shù) {data: "xxx"}，請求結(jié)果如下：
對照請求參數(shù)和返回結(jié)果，可以發(fā)現(xiàn)路由地址中的 :id 占位符解析后被放到 “req.params” 對象下。地址參數(shù) ?tag=test 解析后被放到 “req.query” 對象下。
但是有一個(gè)問題：請求體沒有被解析出來。
這是因?yàn)檎埱篌w是按照流處理的，無法直接獲取到，我們需要一個(gè)第三方工具包協(xié)助。首先安裝如下：
$ yarn add body-parser
然后在 index.js 中引入并加載：
const bodyParser = require('body-parser')
app.use(bodyParser.json())
現(xiàn)在重新請求，接可以看到 req.body 的返回結(jié)果了：
響應(yīng)對象
路由處理函數(shù)的第二個(gè)參數(shù)表示響應(yīng)對象，用于向客戶端返回結(jié)果，也就是定義接口的返回值。路由處理函數(shù)中必須設(shè)置響應(yīng)，否則客戶端請求會一直處于掛起狀態(tài)，無返回值。
常用的響應(yīng)方法有以下三種，用于返回不同類型的數(shù)據(jù)：
- res.json()：發(fā)送 JSON 響應(yīng)。
- res.render()：發(fā)送視圖響應(yīng)（html）。
- res.send()：發(fā)送各種類型的響應(yīng)。
我們統(tǒng)一使用 res.send() 方法響應(yīng)數(shù)據(jù)。一般在響應(yīng)前還可以通過 res.status() 方法設(shè)置 HTTP 狀態(tài)碼，示例如下：
res.send('哈哈') // 狀態(tài)碼：200，返回值："哈哈"
res.status(201).send({
msg: 'created',
}) // 狀態(tài)碼：201，返回值：{msg:"created"}
res.status(401).send('請登錄') // 狀態(tài)碼：401，返回值："請登錄"
發(fā)送響應(yīng)時(shí)也常常會遇到問題，以下兩條原則請牢記，避免踩坑：
- 一個(gè)路由處理函數(shù)中只能響應(yīng)一次，不能重復(fù)響應(yīng)。
- res.send() 不能直接返回?cái)?shù)字。
分組路由
使用 app 實(shí)例注冊路由固然方便，但是如果定義的路由很多，都注冊在 app 實(shí)例下很可能會帶來全局污染，這與全局變量一個(gè)道理。為了應(yīng)用的健壯性，我們應(yīng)該將路由分組。
Express 提供了 Router 類來創(chuàng)建模塊化的路由程序，它像一個(gè)微應(yīng)用，可以隨時(shí)被 app 實(shí)例掛載。這樣就可以把一組路由保存在一個(gè)單獨(dú)的文件中，需要時(shí)加載，從而實(shí)現(xiàn)路由分組。
創(chuàng)建一個(gè) router 文件夾用于保存路由文件，然后創(chuàng)建 router/test.js 文件，在文件中呢寫入路由代碼，如下：
// router/test.js
var express = require('express')
var router = express.Router()
router.post('/info', (req, res) => {
res.send('TEST 路由組')
})
module.exports = router
這樣一個(gè)基本的路由模塊就寫好了，如果讓其生效，需要在主程序中加載該模塊：
const testRouter = require('./router/test.js')
app.use('/test', testRouter)
上述代碼表示請求 “/test” 時(shí)加載路由模塊，訪問某個(gè)路由時(shí)使用該路徑拼接路由地址，像下面這樣：
http://localhost:9000/test/info
# 返回 "TEST 路由組"
為了開發(fā)規(guī)范，我們統(tǒng)一把路由定義為路由模塊，而不直接在 app 下注冊。
理解中間件，搞懂框架原理
Express 應(yīng)用是由一系列中間件構(gòu)成的。中間件同樣是一個(gè)聽著很玄乎的詞兒，但它的本質(zhì)就是一個(gè)函數(shù)。我們看一個(gè)中間件函數(shù)的代碼示例：
var myLogger = function (req, res, next) {
console.log('LOGGED')
next()
}
中間件與普通函數(shù)的區(qū)別就是它有三個(gè)參數(shù)，分別表示請求對象（req），響應(yīng)對象（res）和一個(gè) next() 函數(shù) ——— 也許你發(fā)現(xiàn)了，路由處理函數(shù)也是這個(gè)結(jié)構(gòu)。
沒錯(cuò)，路由處理函數(shù)本身就是一個(gè)中間件。
將中間件掛載到應(yīng)用上，使用 app.use() 方法：
app.use(myLogger)
看到這里你又會發(fā)現(xiàn)，請求體解析包 body-parser 也是這么掛載的，因?yàn)樵摪彩且粋€(gè)中間件。
直接用 app.use() 掛載的中間件在收到任意請求時(shí)都會執(zhí)行。如果要限定執(zhí)行條件，可以添加一個(gè)路徑匹配，如下：
app.use('/test/*', myLogger)
這樣，只有以 /test 開頭的請求才會執(zhí)行 myLogger 中間件，這看起來與路由注冊很相似。其實(shí)注冊路由正是這種中間件掛載方式的快捷寫法，只不過多了一個(gè)請求方法的限制。
Express 應(yīng)用中一切皆中間件，如果匹配到多個(gè)中間件會按照順序依次調(diào)用。此時(shí) next() 函數(shù)就能派上用場了，他的作用是進(jìn)入下一個(gè)中間件。
比如代碼中的 myLogger 中間件，將它掛載到路由之前，那么每次請求首先會打印出 “LOGGED”，然后再進(jìn)入路由處理函數(shù)。
如果 myLogger 中間件中沒有調(diào)用 next() 函數(shù)，請求就會被堵在這里，無法進(jìn)入路由處理函數(shù)，此時(shí)請求會被掛起。
統(tǒng)一錯(cuò)誤處理，提升健壯性
既然一切皆中間件，那么錯(cuò)誤處理也是一個(gè)中間件。錯(cuò)誤處理函數(shù)與其他的中間件函數(shù)稍有不同，它多了一個(gè) err 參數(shù)，如下：
app.use((err, req, res, next) => {
console.error(err.stack)
res.status(500).send('服務(wù)器出錯(cuò)了!')
})
err 參數(shù)表示錯(cuò)誤信息，當(dāng)發(fā)生錯(cuò)誤時(shí)進(jìn)入該中間件，此時(shí)要設(shè)置 HTTP 狀態(tài)碼為 500，并根據(jù)錯(cuò)誤信息為客戶端返回錯(cuò)誤響應(yīng)。
錯(cuò)誤處理中間件是一個(gè)兜底中間件，請確保它定義在所有中間件之后，是應(yīng)用中的最后一個(gè)中間件。
請求進(jìn)入錯(cuò)誤中間件，說明前面的所有中間件都沒有匹配到。但是如果客戶端請求地址寫錯(cuò)而進(jìn)入錯(cuò)誤處理中間件，此時(shí)返回 500 錯(cuò)誤顯然不合理，應(yīng)該是 404 資源未找到。
所以在錯(cuò)誤處理中間件前，還應(yīng)該定義一個(gè) 404 中間件。該中間件要在所有路由之后，錯(cuò)誤處理之前，是應(yīng)用的倒數(shù)第二個(gè)中間件，代碼如下：
app.use((req, res, next) => {
res.status(404).send('Not Found')
})
好了，現(xiàn)在我們的應(yīng)用就健壯多了。
總結(jié)
本文列舉了 Express 框架的核心，并舉例如何應(yīng)用，整體并沒有那么難。掌握這部分知識，可以快速擁 API 開發(fā)的思維。
