閱讀更多系列文章請訪問我的GitHub博客,示例代碼請訪問這裏。
Express介紹
基於 Node.js 平臺,快速、開放、極簡的 Web 開發框架。
Express的特點是易於入門,而且可以使用各種中間件擴展它的功能。
但由於Express開發相對較早,主要使用回調函數進行異步操作,無法使用Async函數,因此原團隊也開發了功能更強大的Koa來解決Express的不足之處。
不過對於開發人員,Express還是不可或缺的一項重要技能。
使用Express創建服務器
示例代碼:/lesson01/server.js
- 在
/lesson01
文件夾通過npm init -y
初始化項目 - 使用
npm install express --save
安裝Express - 引用Express並創建服務器
const express = require('express')
const server = express()
server.listen(8080)
console.log(`Server started at 8080`)
常用路由配置方法
示例代碼:/lesson01/server.js
通常接收到的請求不止get方法,常用的有:
server.get
,處理get請求server.post
,處理post請求server.use
,處理所有方法的請求,它的第一個路由參數可以不傳,此時表示處理所有接口請求,如下:
server.use('/first', (req, res, next) => {
console.log('first')
next()
})
除了這3個方法之外,還有server.put、server.delete等方法,具體可以查看文檔
添加路由
示例代碼:/lesson01/server.js
Express自帶了路由功能,不需要引用中間件即可添加路由。
server.get('/first', (req, res, next) => {
res.send({
error: 0,
msg: '請求成功'
})
})
代碼含義如下:
- 創建了一個get請求的路由。
- 第一個參數’/first’表示請求的路由名稱。
- 第二個參數爲回調函數。
- 回調函數傳參req表示請求參數實例。
- 回調函數傳參res表示響應參數實例。
- next用於觸發下一步操作。
- res.send可以向前臺發送數據,與原生node.js的res.write方法不同,它不止可以發送Buffer、字符串,還可以直接發送JSON等數據,如下:
res.send(new Buffer('wahoo'));
res.send({ some: 'json' });
res.send('<p>some html</p>');
res.send(404, 'Sorry, cant find that');
res.send(404);
此時訪問http://localhost:8080/first,即可看到頁面顯示:{"error":0,"msg":"請求成功"}
。
next方法的使用
示例代碼:/lesson01/server.js
next方法的作用是用於對請求的多級處理,例如:
server.get('/second', (req, res, next) => {
if (Number(req.query.num) > 10) {
// 滿足條件時,纔可觸發同名的下一個路由。
next()
} else {
res.send({
error: 1,
msg: '請輸入大於10的數字'
})
}
})
server.get('/second', (req, res, next) => {
res.send({
error: 0,
msg: '輸入成功'
})
})
代碼含義如下:
- 若配置了多個同名路由,代碼會從上到下按順序執行,但如果未調用next方法,執行過程會中斷。
- 如果接口傳參爲http://localhost:8080/second?num=8,無法滿足num > 10的條件,則不會執行第二個/second路由回調函數中代碼,直接返回錯誤。
- 如果接口傳參爲http://localhost:8080/second?num=80,滿足了num > 10的條件,則可以執行第二個/second路由回調函數中代碼,進行下一步處理。
- next方法在處理中間件時十分有用,因爲在各級中間件的處理中,可以通過next方法判斷是否需要執行下一級處理,
next方法傳參
示例代碼:/lesson01/server.js
有時會需要給下一級的處理傳參,只要直接給req實例中添加屬性即可,但請注意不要覆蓋系統默認屬性,如下:
server.get('/second', (req, res, next) => {
if (Number(req.query.num) > 10) {
// 滿足條件時,纔可觸發同名的下一個路由。
req.randomNum = Math.floor(Math.random() * 100)
next()
} else {
res.send({
error: 1,
msg: '請輸入大於10的數字'
})
}
})
server.get('/second', (req, res, next) => {
res.send({
error: 0,
msg: `輸入成功,接收到的隨機數爲${req.randomNum}`
})
})
訪問http://localhost:8080/second?num=80即可看到前臺打印出的req.randomNum結果。