使用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
