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.parse(queryString)["foo"]    |
                                            |
                         querystring.parse(queryString)["hello"]

當然我們也可以用 querystring 模塊來解析 POST 請求體中的參數,稍後會有演示。

現在我們來給 onRequest() 函數加上一些邏輯,用來找出瀏覽器請求的 URL 路徑:

server.js 文件代碼:

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 的文件,添加以下內容:

router.js 文件代碼:

function route(pathname) { console.log("About to route a request for " + pathname); } exports.route = route;

如你所見,這段代碼什麼也沒幹,不過對於現在來說這是應該的。在添加更多的邏輯以前,我們先來看看如何把路由和服務器整合起來。

我們的服務器應當知道路由的存在並加以有效利用。我們當然可以通過硬編碼的方式將這一依賴項綁定到服務器上,但是其它語言的編程經驗告訴我們這會是一件非常痛苦的事,因此我們將使用依賴注入的方式較鬆散地添加路由模塊。

首先,我們來擴展一下服務器的 start() 函數,以便將路由函數作為參數傳遞過去,server.js 文件代碼如下

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,使得路由函數可以被注入到服務器中:

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/,輸出結果如下: