当前位置：首页 > 资讯 > 技术文档

浅析Node.js实现HTTP文件下载

时间：2021-06-26 06:43 编辑：来源：阅读：
扫一扫，手机访问

摘要：浅析Node.js实现HTTP文件下载

[b]前言[/b] HTTP实现文件下载时，只要在服务器设置好相关响应头，并使用二进制传输文件数据即可，而客户端(浏览器)会根据响应头接收文件数据。而在Node.js中，设置好响应头后，读取文件流，再使用[code]“.pipe()”[/code]方法将流转接到响应对象[code]Response[/code]就可以实现一个简单的文件下载服务器。 [b]1. 文件下载介绍[/b] HTTP基于请求头和响应头实现状态交互，在得到服务器正确响应状态后，而客户端首先会解析响应头，并根据响应头来接收和展示数据（响应体）。对于文件下载来说，其实现过程如下： 1.客户端发起文件资源请求 2.服务器查找对应文件，并设置”[code]Content-Type[/code]”、”[code]Content-Disposition[/code]”等响应头，分别用于表示文件的”MIME”类型及文件描述 3.客户端根据服务器返回的响应头解析和接收文件数据 [b]需要设置的响应头[/b] 设置文件下载响应头时，除了常用的HTTP响应头外，比较重要是还要设置以下两个响应头：

Content-Type: application/octet-stream
Content-Disposition: attachment; filename=MyFileName.ext

在上面的设置中，”[code]Content-Type: application/octet-stream[/code]”告诉浏览器这是一个二进制文件，”[code]Content-Disposition[/code]”告诉浏览器这是一个需要下载的附件并告诉浏览器默认的文件名。如果不添加”[code]Content-Disposition[/code]”响应头，浏览器可能会下载或显示文件内容，不同浏览器的处理有所不同。 [b]2. Node.js文件下载服务器实现[/b] 接下来我们基于Express 框架实现一个简单文件下载服务器，在这个服务器中主要包括两个功能：[b]服务器文件的浏览[/b]、[b]文件的下载[/b]。 [b]2.1 添加路由[/b] 创建Express应用后，添加如下两个路由：

router.get('/files', function(req, res, next) {
 // 显示服务器文件 
});
router.get('/file/:fileName', function(req, res, next) {
 // 实现文件下载 
});

上面的添加的两个路由分别用于：[b]显示服务器文件、实现文件下载[/b]。 [b]2.2 显示服务器文件[/b] 实现服务器文件的显示，要通过”[code]fs[/code]”模块[b]读取文件目录[/b]并进行[b]文件/目录检查[/b]等。还需要使用”[b]path[/b]”模块处理文件路径。首先引入这两个模块：

const fs = require('fs');
const path = require('path');

显示服务器文件实现代码如下：

router.get('/files', function(req, res, next) {
 // 显示服务器文件 
 // 文件目录
 var filePath = path.join(__dirname, './');
 fs.readdir(filePath, function(err, results){
  if(err) throw err;
  if(results.length>0) {
   var files = [];
   results.forEach(function(file){
   if(fs.statSync(path.join(filePath, file)).isFile()){
     files.push(file);
   }
   })
   res.render('files', {files:files});
  } else {
   res.end('当前目录下没有文件');
  }
 });
});

上面代码中，读取目录后通过视图文件”[code]files.ejs[/code]”显示可下载文件列表。其代码如下：

<!DOCTYPE html>
<html>
 <head>
  <title>下载文件选择</title>
 </head>
 <body>
  <h1>请选择下载文件：</h1>
  <% if(files.length>0) {%>
  <ul>
   <% files.forEach(function(file){ %>
   <li>
    <a href="/file/<%- file %>" target="_blank"><%- file %></a>
   </li>
   <%})%>
  </ul>
  <%} else {%>
  <p>没有可下载文件…</p>
  <%}%>
 </body>
</html>

[b]2.3 实现文件下载[/b] 实现文件下载时，可以先读取文件到一个”[code]Buffer[/code]”中，再通过”[code]res.send()”[/code]或”[code]res.end()”[/code]方法发送文件数据，也可以基于流（”[code]Stream[/code]”）实现文件数据的发送。使用”[code]Stream[/code]”实现文件下载时，可以使用”[code]fs.createReadStream()”[/code]方法创建一个可读流，而响应对象[code]Response[/code]是一个可写流。这样，只需要通过[code]”.pipe()”[/code]方法将文件流转接到[code]Response[/code]响应流中即可。文件下载实现代码如下：

router.get('/file/:fileName', function(req, res, next) {
 // 实现文件下载 
 var fileName = req.params.fileName;
 var filePath = path.join(__dirname, fileName);
 var stats = fs.statSync(filePath); 
 if(stats.isFile()){
  res.set({
   'Content-Type': 'application/octet-stream',
   'Content-Disposition': 'attachment; filename='+fileName,
   'Content-Length': stats.size
  });
  fs.createReadStream(filePath).pipe(res);
 } else {
  res.end(404);
 }
});

[b]总结[/b] 以上就是利用Node.js实现HTTP文件下载的全部内容，希望对大家学习Node.js有所帮助。

全部评论(0)

上一篇：C#实现复杂XML的序列化与反序列化
下一篇：JSP文件下载功能的4种方法

资讯排行榜
更多>>