使用 Node.js 搭建 Web 服务器

使用Node.js搭建Web服务器是学习Node.js比较全面的入门教程,由于实现Web服务器须要用到几个比较重要的模块:http模块、文件系统、url解析模块、路径解析模块、以及301重定向技术等,下面咱们就一块儿来学习如何搭建一个简单的Web服务器。css

做为一个Web服务器应具有如下几个功能:html

  • 能显示以 .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/ , 这样能够解决内部资源引用错位的问题。

引入须要用到的几个模块:node

// http协议模块
var http = require('http');
// url解析模块
var url = require('url');
// 文件系统模块
var fs = require('fs');
// 路径解析模块
var path = require('path');

建立服务并在指定的端口监听:git

// 建立一个服务
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 是用来设置响应头以及对客户端作出响应操做。github

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);
            }
        }
    });
}

请求处理函数中有几个重点须要说一下:web

对于路径中有中文的,浏览器会自动进行编码(英文不变,中文会变),所以在接收到地址后,须要对地址进行解码,不然最后获得的路径和真实路径不相符,json

当访问路径不是以具体的文件结尾,而且不是以/结尾,则须要经过重定向加上/,表示当前目录,不然当前路径下的静态资源会找不到。浏览器

若是访问路径是目录,则列出该目录下全部文件及文件夹,并能够点击访问,为了让中文目录能正常显示,则还要在header中设置charset=utf-8服务器

核心代码就这么多,大概140行左右,完整的代码已上传到 github : https://github.com/git-onepixel/Node,  函数

若是要运行demo,打开 cmd 切换到根目录,运行 node start 便可。

若有问题,欢迎讨论!

 

原创发布 @一像素 2016.03