使用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
核心代碼就這麼多,大概140行左右,完整的代碼已上傳到 github : https://github.com/git-onepixel/Node,
如果要運作demo,打開 cmd 切換到根目錄,運作 node start 即可。
如有問題,歡迎讨論!
原創釋出 @一像素 2016.03