Node.js 路由
我們要為路由提供請求的URL和其他需要的GET及POST參數,隨後路由需要根據這些資料來執行對應的程式碼。
因此,我們需要查看HTTP請求,從中提取請求的URL以及GET/POST參數。這項功能應屬於路由或伺服器(甚至作為一個模組本身的功能)確實值得探討,但這裡暫定其為我們的HTTP伺服器的功能。
我們需要的所有資料都會包含在request物件中,該物件作為onRequest()回呼函數的第一個參數傳遞。但為了解析這些數據,我們需要額外的Node.JS模組,它們分別是url和querystring模組。
url.parse(string).query | url.parse(string).pathname | | | | | ------ ------------------- http://localhost:8888/start?foo=bar&hello=world --- ----- | | | | querystring(string)["foo"] | | querystring(string)["hello"]
當然我們也可以用querystring模組來解析POST請求體中的參數,稍後會有示範。
現在我們來為onRequest()函數加上一些邏輯,用來找出瀏覽器請求的URL路徑:
var http = require("http"); var url = require("url"); function start() { function onRequest(request, response) { var pathname = url.parse(request.url).pathname; console.log("Request for " + pathname + " received."); response.writeHead(200, {"Content-Type": "text/plain"}); response.write("Hello World"); response.end(); } http.createServer(onRequest).listen(8888); console.log("Server has started."); } exports.start = start;
好了,我們的應用程式現在可以通過請求的URL路徑來區別不同請求了--這使我們得以使用路由(還未完成)來將請求以URL路徑為基準映射到處理程序上。
在我們所要建置的應用程式中,這表示來自/start和/upload的請求可以使用不同的程式碼來處理。稍後我們將看到這些內容是如何整合在一起的。
現在我們可以來寫路由了,建立一個名為router.js 的文件,加入以下內容:
function route(pathname) { console.log("About to route a request for " + pathname); } exports.route = route;
如你所見,這段程式碼什麼也沒幹,不過對現在來說這是應該的。在增加更多的邏輯以前,我們先來看看如何把路由和伺服器整合起來。
我們的伺服器應知道路由的存在並加以有效利用。我們當然可以透過硬編碼的方式將這一依賴項綁定到伺服器上,但是其它語言的程式設計經驗告訴我們這會是一件非常痛苦的事,因此我們將使用依賴注入的方式較鬆散地添加路由模組。
首先,我們來擴展一下伺服器的start()函數,以便將路由函數作為參數傳遞過去,server.js 檔案程式碼如下
var http = require("http"); var url = require("url"); function start(route) { function onRequest(request, response) { var pathname = url.parse(request.url).pathname; console.log("Request for " + pathname + " received."); route(pathname); response.writeHead(200, {"Content-Type": "text/plain"}); response.write("Hello World"); response.end(); } http.createServer(onRequest).listen(8888); console.log("Server has started."); } exports.start = start;
同時,我們會相應擴展index.js,使得路由函數可以被注入到伺服器中:
var server = require("./server"); var router = require("./router"); server.start(router.route);
在這裡,我們傳遞的函數依舊什麼也沒做。
如果現在啟動應用程式(node index.js,始終記得這個命令列),隨後請求一個URL,你將會看到應用程式輸出對應的訊息,這表示我們的HTTP伺服器已經在使用路由模組了,並將請求的路徑傳遞給路由:
$ node index.js Server has started.
以上輸出已經去掉了比較煩人的/favicon.ico請求相關的部分。
瀏覽器造訪 http://127.0.0.1:8888/,輸出結果如下:
##