天天看點

使用 Node.js 搭建 Web 伺服器

使用Node.js搭建Web伺服器是學習Node.js比較全面的入門教程,因為實作Web伺服器需要用到幾個比較重要的子產品:http子產品、檔案系統、url解析子產品、路徑解析子產品、以及301重定向技術等,下面我們就一起來學習如何搭建一個簡單的Web伺服器。

作為一個Web伺服器應具備以下幾個功能:

  • 能顯示以 .html/.htm 結尾的 Web 頁面
  • 能直接打開以 .js/.css/.json/.text 結尾的檔案内容
  • 顯示圖檔資源
  • 自動下載下傳以 .apk/.docx/.zip 結尾的檔案
  • 形如 http://xxx.com/a/b/ ,  則查找b目錄下是否有index.html, 如果有就顯示,如果沒有就列出該目錄下的所有檔案及檔案夾,并可以進一步通路。
  • 形如 http://xxx.com/a/b,  則作301重定向到 http://xxx.com/a/b/ , 這樣可以解決内部資源引用錯位的問題。

引入需要用到的幾個子產品:

// http協定子產品
var http = require('http');
// url解析子產品
var url = require('url');
// 檔案系統子產品
var fs = require('fs');
// 路徑解析子產品
var path = require('path');      

建立服務并在指定的端口監聽:

// 建立一個服務
var httpServer = http.createServer(this.processRequest.bind(this));

// 在指定的端口監聽服務
httpServer.listen(port, function() {
    console.log('[HttpServer][Start]', 'runing at http://' + ip + ':' + port + '/');
    console.timeEnd('[HttpServer][Start]');
});      

在建立服務的時候需要傳遞一個匿名函數 processRequest 對請求進行處理,processRequest接收兩個參數,分别是 request 和 response, request 對象中包含了請求的所有内容,response 是用來設定響應頭以及對用戶端做出響應操作。

processRequest: function (request, response) {
    var hasExt = true;
    var requestUrl = request.url;
    var pathName = url.parse(requestUrl).pathname;

    // 對請求的路徑進行解碼,防止中文亂碼
    pathName = decodeURI(pathName);

    // 如果路徑中沒有擴充名
    if (path.extname(pathName) === '') {
        // 如果不是以/結尾的,加/并作301重定向
        if (pathName.charAt(pathName.length-1) != '/'){
            pathName += '/';
            var redirect = 'http://' + request.headers.host + pathName;
            response.writeHead(301, {
                location: redirect
            });
            response.end();
            return ;
        }
        // 添加預設的通路頁面,但這個頁面不一定存在,後面會處理
        pathName += 'index.html';
        hasExt = false; // 标記預設頁面是程式自動添加的
    }

    // 擷取資源檔案的相對路徑
    var filePath = path.join('http/webroot', pathName);

    // 擷取對應檔案的文檔類型
    var contentType = this.getContentType(filePath);

    // 如果檔案名存在
    fs.exists(filePath, function(exists) {
        if (exists) {
            response.writeHead(200, {'content-type': contentType});
            var stream = fs.createReadStream(filePath, {flags: 'r', encoding: null});
            stream.on('error', function () {
                response.writeHead(500, {'content-type': 'text/html'});
                response.end('<h1>500 Server Error</h1>');
            });
            // 傳回檔案内容
            stream.pipe(response);
        } else { // 檔案名不存在的情況
            if (hasExt) {
                // 如果這個檔案不是程式自動添加的,直接傳回404
                response.writeHead(404, {'content-type': 'text/html'});
                response.end('<h1>404 Not Found</h1>');
            } else {
                // 如果檔案是程式自動添加的且不存在,則表示使用者希望通路的是該目錄下的檔案清單
                var html = "<head><meta charset='utf-8'></head>";
                try {
                    // 使用者通路目錄
                    var filedir = filePath.substring(0, filePath.lastIndexOf('\\'));
                    // 擷取使用者通路路徑下的檔案清單
                    var files = fs.readdirSync(filedir);
                    // 将通路路徑下的是以檔案一一列舉出來,并添加超連結,以便使用者進一步通路
                    for (var i in files) {
                        var filename = files[i];
                        html += "<div><a  href='" + filename + "'>" + filename + "</a></div>";
                    }
                } catch (e){
                    html += '<h1>您通路的目錄不存在</h1>';
                }
                response.writeHead(200, {'content-type': 'text/html'});
                response.end(html);
            }
        }
    });
}      

請求處理函數中有幾個重點需要說一下:

對于路徑中有中文的,浏覽器會自動進行編碼(英文不變,中文會變),是以在接收到位址後,需要對位址進行解碼,否則最後得到的路徑和真實路徑不相符,

當通路路徑不是以具體的檔案結尾,并且不是以/結尾,則需要通過重定向加上/,表示目前目錄,否則目前路徑下的靜态資源會找不到。

如果通路路徑是目錄,則列出該目錄下所有檔案及檔案夾,并可以點選通路,為了讓中文目錄能正常顯示,則還要在header中設定charset=utf-8

使用 Node.js 搭建 Web 伺服器

核心代碼就這麼多,大概140行左右,完整的代碼已上傳到 github : https://github.com/git-onepixel/Node,  

如果要運作demo,打開 cmd 切換到根目錄,運作 node start 即可。

如有問題,歡迎讨論!

原創釋出 @一像素 2016.03

繼續閱讀