使用 Node.js 搭建 Web 服务器

时间：2022-05-22 15:14:35

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

相关文章