Express簡(jiǎn)介
是一個(gè)簡(jiǎn)潔而靈活的node.js Web應(yīng)用框架，提供了一系列強(qiáng)大特性幫助創(chuàng)建各種Web應(yīng)用和豐富的HTTP工具
核心特性
- 可以設(shè)置中間件來(lái)響應(yīng)HTTP請(qǐng)求
- 定義了路由表用于執(zhí)行不同的HTTP請(qǐng)求動(dòng)作
- 可以通過(guò)向模板傳遞參數(shù)來(lái)動(dòng)態(tài)渲染HTML頁(yè)面
路由
路由的介紹
可以為一個(gè)路徑同時(shí)映射多個(gè)路由，這樣當(dāng)訪(fǎng)問(wèn)該路徑時(shí)，多個(gè)路由都會(huì)被觸發(fā)洗显，觸發(fā)順序是按照路由的設(shè)置順序觸發(fā)的亲配，多個(gè)路由只能返回一個(gè)響應(yīng)咬展；
同一次請(qǐng)求里的req和res一定是相同的對(duì)象耸峭，哪怕是配置的多個(gè)路由；
可以通過(guò)next來(lái)控制路由是否向下進(jìn)行蝉稳，如果不調(diào)用next抒蚜，則不會(huì)向下繼續(xù)，而調(diào)用next則會(huì)觸發(fā)下一個(gè)路由
路由的設(shè)置
路由的設(shè)置方式：
app.<method>(path,callback);
< method>表示要處理的請(qǐng)求方式耘戚，可以是get post或all;
path 是服務(wù)器端的路徑嗡髓，也是要映射的路徑，以斜杠/開(kāi)頭收津，斜杠/代表根目錄器贩；
callback是當(dāng)路由匹配到時(shí)需要執(zhí)行的函數(shù)，當(dāng)path對(duì)應(yīng)的地址被訪(fǎng)問(wèn)時(shí)朋截，要調(diào)用的回調(diào)函數(shù)，回調(diào)函數(shù)中有三個(gè)參數(shù)——req吧黄、res部服、next
以下為設(shè)置路由的兩種方式：
app.get("/hello",function (req , res , next) {});
// GET 方法請(qǐng)求路由
app.get('/', function (req, res) {
res.send('GET request to the homepage');
});
// POST 方法請(qǐng)求路由
app.post('/', function (req, res) {
res.send('POST request to the homepage');
});
路由路徑
路由路徑和請(qǐng)求方法一起定義了請(qǐng)求的端點(diǎn)，可以是字符串拗慨、字符串模式廓八、正則表達(dá)式
url地址的格式：
協(xié)議名：//域名/ip地址：端口號(hào)/路徑/資源名奉芦？查詢(xún)字符串
相對(duì)路徑：
指相對(duì)于當(dāng)前資源所在目錄的位置；
在服務(wù)器中剧蹂，路徑都是相對(duì)于虛擬路徑的声功；
相對(duì)路徑使用.或..開(kāi)頭，或者直接寫(xiě)路徑宠叼；“.”或直接寫(xiě)路徑表示在當(dāng)前文件夾中尋找先巴；”..”表示去上一級(jí)文件夾中尋找；
絕對(duì)路徑：
絕對(duì)路徑使用“/”開(kāi)頭冒冬；
/代表的是服務(wù)器中的根目錄伸蚯；
絕對(duì)路徑永遠(yuǎn)相對(duì)于服務(wù)器的根目錄，不會(huì)因?yàn)槲募奈恢玫母淖兌淖儯?br> 在開(kāi)發(fā)環(huán)境是服務(wù)器的時(shí)候简烤，應(yīng)該使用絕對(duì)路徑剂邮，而不是用相對(duì)路徑;
request和response對(duì)象
request對(duì)象
request對(duì)象表示HTTP請(qǐng)求，包含了請(qǐng)求查詢(xún)字符串横侦、參數(shù)挥萌、內(nèi)容、HTTP頭部等屬性
常見(jiàn)屬性——
req.hostname / req.ip：獲取主機(jī)名和IP地址枉侧；
req.originalUrl：獲取原始請(qǐng)求URL引瀑，請(qǐng)求首頁(yè)的路徑；
req.path：獲取請(qǐng)求路徑
req.protocol：獲取協(xié)議類(lèi)型
req.query：獲取URL的查詢(xún)參數(shù)串
req.route：獲取當(dāng)前匹配的路由
req.header：所有的請(qǐng)求頭
req.get()：獲取指定的HTTP請(qǐng)求頭
req.is()：判斷請(qǐng)求頭Content-Type的MIME類(lèi)型
response對(duì)象
response對(duì)象表示HTTP響應(yīng)棵逊，即在接收到請(qǐng)求時(shí)服務(wù)器向客戶(hù)端發(fā)送的HTTP響應(yīng)數(shù)據(jù)
常見(jiàn)屬性——
res.set()在res.append()后將重置之前設(shè)置的頭伤疙；
res.set()：設(shè)置HTTP頭，傳入object可以一次設(shè)置多個(gè)頭
res.download()：
將文件設(shè)置為響應(yīng)頭并提供給客戶(hù)端進(jìn)行下載辆影；
使用該方法發(fā)送的文件徒像，無(wú)論瀏覽器是否能打開(kāi)，都會(huì)彈出下載窗口蛙讥；
res.sendFile( pa th [,o pt io n s ] [锯蛀，f n ] )：將文件設(shè)置響應(yīng)體并發(fā)送給客戶(hù)端；使用該方法發(fā)送的文件次慢，如果瀏覽器能打開(kāi)則自動(dòng)打開(kāi)旁涤，否則將會(huì)彈出下載窗口。
將文件設(shè)置響應(yīng)體并發(fā)送給客戶(hù)端
使用該方法發(fā)送的文件迫像，如果瀏覽器能打開(kāi)則自動(dòng)打開(kāi)劈愚，否則將會(huì)彈出下載窗口；
res.get()：返回指定的HTTP頭
res.location()：只設(shè)置響應(yīng)的Location HTTP頭闻妓，不設(shè)置狀態(tài)碼或者close response
res.send()：傳送HTTP響應(yīng)菌羽，設(shè)置的僅僅只是響應(yīng)體！而響應(yīng)首行和響應(yīng)響應(yīng)頭默認(rèn)已經(jīng)設(shè)置好了由缆。注意注祖，send請(qǐng)求只能調(diào)用一次猾蒂！
res.sendStatus()服務(wù)器發(fā)送給瀏覽器的響應(yīng)狀態(tài)碼；
get方式設(shè)置路由
app.get()用來(lái)設(shè)置get()路由
參數(shù)為兩個(gè)是晨，一個(gè)為路由映射的請(qǐng)求地址肚菠，第二個(gè)為回調(diào)函數(shù)
app.get('/example/b', function (req, res, next) {
console.log('通過(guò)路由發(fā)送內(nèi)容');
next();
}, function (req, res) {
res.send('你好，我是hello路由返回的內(nèi)容');
});
post方式設(shè)置路由
app.post()用來(lái)設(shè)置post路由
app.post('/process_post', urlencodedParser, function (req, res) {
// 輸出 JSON 格式
var response = {
"first_name":req.body.first_name,
"last_name":req.body.last_name
};
console.log(response);
res.end(JSON.stringify(response));
})
Express.Router
Express.Router作為一個(gè)單獨(dú)的組件罩缴，類(lèi)似小型的express應(yīng)用程序一樣蚊逢，有自己的use、get靴庆、param时捌、route方法
使用 express.Router 類(lèi)創(chuàng)建模塊化、可掛載的路由句柄炉抒，Router 實(shí)例是一個(gè)完整的中間件和路由系統(tǒng)奢讨，因此常稱(chēng)其為一個(gè) “mini-app”
基本用法
Express.Router是一個(gè)構(gòu)造函數(shù)，調(diào)用后返回一個(gè)路由器實(shí)例焰薄。然后拿诸，使用該實(shí)例的HTTP動(dòng)詞方法，為不同的訪(fǎng)問(wèn)路徑指定回調(diào)函數(shù)塞茅；最后亩码，掛載到某個(gè)路徑
var express = require('express');
var router = express.Router();
router.get('/', function(req, res) {
res.send('首頁(yè)');
});
router.get('/about', function(req, res) {
res.send('關(guān)于');
});
app.use('/', router);
router.use()方法為router對(duì)象指定中間件，在數(shù)據(jù)正式發(fā)給用戶(hù)之前野瘦，對(duì)數(shù)據(jù)進(jìn)行處理
router.use(function(req, res, next) {
console.log(req.method, req.url);
next();
});
router.param()方法用于路徑參數(shù)的處理,param方法必須放在HTTP動(dòng)詞方法之前
router.param('name', function(req, res, next, name) {// 對(duì)name進(jìn)行驗(yàn)證或其他處理…… console.log(name);
req.name = name;
next();
});
router.get('/hello/:name', function(req, res) {
res.send('hello ' + req.name + '!');
});
HTTP模塊
express框架建立在node.js內(nèi)置的http模塊上
http模塊生成服務(wù)器的原始代碼如下：
var http = require("http");
var app = http.createServer(function(request,response){
response.writeHead(200, {"Content-Type":"text/plain"});
response.end("Hello world!");
});
app.listen(3000, "localhost");
express框架的核心是對(duì)http模塊的再包裝：
var express = require('express');
var app = express();
app.get('/', function (req, res) {
res.send('Hello world!');
});
app.listen(3000);
兩者差別在于express框架在http模塊上加了一個(gè)中間層
中間件
express和中間件的關(guān)系
Express 是一個(gè)自身功能極簡(jiǎn)描沟，完全是由路由和中間件構(gòu)成一個(gè)的 web 開(kāi)發(fā)框架：從本質(zhì)上來(lái)說(shuō)，一個(gè) Express 應(yīng)用就是在調(diào)用各種中間件
中間件的性質(zhì)
每個(gè)中間件都是一個(gè)handler鞭光，用來(lái)處理HTTP請(qǐng)求的函數(shù)吏廉，依次傳入request，response惰许，next三個(gè)參數(shù)
中間件講究順序席覆，匹配上第一個(gè)之后，就不會(huì)往后匹配了汹买。next函數(shù)才能夠繼續(xù)往后匹配
基本的中間件結(jié)構(gòu)如下：
function myFunMiddleware(request, response, next) {
// 對(duì)request和response作出相應(yīng)操作
// 操作完畢后返回next()即可轉(zhuǎn)入下個(gè)中間件
next();
}
中間件的功能
- 執(zhí)行任何代碼
- 修改請(qǐng)求和相應(yīng)對(duì)象
- 終結(jié)請(qǐng)求-響應(yīng)循環(huán)
- 調(diào)用堆棧中的下一個(gè)中間件
如果當(dāng)前中間件沒(méi)有終結(jié)請(qǐng)求-響應(yīng)循環(huán)佩伤，則必須調(diào)用next()方法將控制權(quán)交給下一個(gè)中間件，否則請(qǐng)求就會(huì)被掛起
中間件的分類(lèi)
Express應(yīng)用可以使用如下幾種中間件：
- 應(yīng)用級(jí)中間件
應(yīng)用級(jí)中間件綁定到app對(duì)象晦毙，使用app.use(),app.get(),app.post(),app.put() - 路由級(jí)中間件
路由級(jí)中間件綁定的對(duì)象為express.Router() - 錯(cuò)誤處理中間件
錯(cuò)誤處理中間件和其他中間件定義類(lèi)似生巡，只是要使用4個(gè)參數(shù)：err,req,res,next
app.use(function(err, req, res, next) {
console.error(err.stack);
res.status(500).send('Something broke!');
});
- 內(nèi)置中間件
express.static是express唯一內(nèi)置的中間件，基于serve-static见妒，負(fù)責(zé)在express應(yīng)用中托管靜態(tài)資源 - 第三方中間件
通過(guò)使用第三方中間件從而為express應(yīng)用增加更多功能孤荣。
安裝所需功能的node模塊，并在應(yīng)用中加載，可以在應(yīng)用級(jí)加載垃环，也可以在路由級(jí)加載
use方法
use是express注冊(cè)中間件的方法，它返回一個(gè)函數(shù)
調(diào)用幾次app.use()就注冊(cè)了幾個(gè)中間件
use方法內(nèi)部可以對(duì)訪(fǎng)問(wèn)路徑進(jìn)行判斷返敬，據(jù)此實(shí)現(xiàn)簡(jiǎn)單的路由根據(jù)不同的請(qǐng)求網(wǎng)址遂庄，返回不同的網(wǎng)頁(yè)內(nèi)容
方法一：
在回調(diào)函數(shù)內(nèi)部判斷請(qǐng)求的網(wǎng)址：
var express = require("express");var http = require("http");var app = express();
app.use(function(request, response, next) { if (request.url == "/") {
response.writeHead(200, { "Content-Type": "text/plain" });
response.end("Welcome to the homepage!\n");
} else {
next();
}
});
app.use(function(request, response, next) { if (request.url == "/about") {
response.writeHead(200, { "Content-Type": "text/plain" });
} else {
next();
}
});
app.use(function(request, response) {
response.writeHead(404, { "Content-Type": "text/plain" });
response.end("404 error!\n");
});
http.createServer(app).listen(1337);
方法二：
允許將請(qǐng)求網(wǎng)址寫(xiě)在第一個(gè)參數(shù)，表示只有請(qǐng)求路徑匹配了這個(gè)參數(shù)劲赠，后面的中間件才生效
app.use('/path', someMiddleware);
API
express()
創(chuàng)建Express應(yīng)用程序
express()函數(shù)是express模塊導(dǎo)出的頂級(jí)函數(shù)
var express = require('express');
var app = express();
express.json([options])
是Express中的內(nèi)置中間件功能涛目，使用JSON有效負(fù)載解析傳入的請(qǐng)求
express.static(root,[options])
是Express中的內(nèi)置中間件功能
提供靜態(tài)文件，基于serve-static凛澎，root參數(shù)指定從中提供靜態(tài)資源的根目錄
該函數(shù)通過(guò)req.url與提供的root目錄組合來(lái)確定要提供的文件霹肝，當(dāng)找不到文件時(shí)，它不是返回404響應(yīng)塑煎，而是調(diào)用next()繼續(xù)下一個(gè)中間件沫换，允許堆疊和回退
exoress.Router([options])
創(chuàng)建一個(gè)新的路由器對(duì)象
var router = express.Router([options]);
可選options參數(shù)指定路由器的行為：
- caseSensitive
啟用區(qū)分大小寫(xiě)，默認(rèn)情況下禁用 - mergeParams
保留req.params父路由器的值最铁。如果父級(jí)和子級(jí)具有沖突的參數(shù)名稱(chēng)讯赏，則子級(jí)的值優(yōu)先。默認(rèn)值為false - strict
啟用嚴(yán)格路由冷尉，默認(rèn)情況下禁用
express.urlencoded([options])
是Express中的內(nèi)置中間件功能
可選options對(duì)象的屬性值如下：
- extended
- inflate
- limit
- parameterLimit
- type
- verify
