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


Posted in Javascript onAugust 05, 2016

前言

HTTP实现文件下载时,只要在服务器设置好相关响应头,并使用二进制传输文件数据即可,而客户端(浏览器)会根据响应头接收文件数据。而在Node.js中,设置好响应头后,读取文件流,再使用“.pipe()”方法将流转接到响应对象Response就可以实现一个简单的文件下载服务器。

1. 文件下载介绍

HTTP基于请求头和响应头实现状态交互,在得到服务器正确响应状态后,而客户端首先会解析响应头,并根据响应头来接收和展示数据(响应体)。对于文件下载来说,其实现过程如下:

    1.客户端发起文件资源请求

    2.服务器查找对应文件,并设置”Content-Type”、”Content-Disposition”等响应头,分别用于表示文件的”MIME”类型及文件描述

    3.客户端根据服务器返回的响应头解析和接收文件数据

需要设置的响应头

设置文件下载响应头时,除了常用的HTTP响应头外,比较重要是还要设置以下两个响应头:

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

在上面的设置中,”Content-Type: application/octet-stream”告诉浏览器这是一个二进制文件,”Content-Disposition”告诉浏览器这是一个需要下载的附件并告诉浏览器默认的文件名。如果不添加”Content-Disposition”响应头,浏览器可能会下载或显示文件内容,不同浏览器的处理有所不同。

2. Node.js文件下载服务器实现

接下来我们基于Express 框架实现一个简单文件下载服务器,在这个服务器中主要包括两个功能:服务器文件的浏览文件的下载

2.1 添加路由

创建Express应用后,添加如下两个路由:

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

上面的添加的两个路由分别用于:显示服务器文件、实现文件下载

2.2 显示服务器文件

实现服务器文件的显示,要通过”fs”模块读取文件目录并进行文件/目录检查等。还需要使用”path”模块处理文件路径。首先引入这两个模块:

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('当前目录下没有文件');
  }
 });
});

上面代码中,读取目录后通过视图文件”files.ejs”显示可下载文件列表。其代码如下:

<!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>

2.3 实现文件下载

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

文件下载实现代码如下:

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

总结

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

Javascript 相关文章推荐
关于javascript event flow 的一个bug详解
Sep 17 Javascript
Jquery获取元素的父容器对象示例代码
Feb 10 Javascript
JQuery each()嵌套使用小结
Apr 18 Javascript
PHP使用方法重载实现动态创建属性的get和set方法
Nov 17 Javascript
基于MVC4+EasyUI的Web开发框架形成之旅之界面控件的使用
Dec 16 Javascript
AngularJS入门教程之Select(选择框)详解
Jul 27 Javascript
jQuery grep()方法详解及实例代码
Oct 30 Javascript
整理关于Bootstrap警示框的慕课笔记
Mar 29 Javascript
vue-cli 2.*中导入公共less文件的方法步骤
Nov 22 Javascript
Jquery实现获取子元素的方法分析
Aug 24 jQuery
Vue数组响应式操作及高阶函数使用代码详解
Aug 01 Javascript
js判断两个数组相等的5种方法
May 06 Javascript
JS中对Cookie的操作详解
Aug 05 #Javascript
jQuery插件EasyUI获取当前Tab中iframe窗体对象的方法
Aug 05 #Javascript
js实现精确到毫秒的倒计时效果
Aug 05 #Javascript
jQuery实现Select左右复制移动内容
Aug 05 #Javascript
jQuery插件EasyUI实现Layout框架页面中弹出窗体到最顶层效果(穿越iframe)
Aug 05 #Javascript
jQuery插件EasyUI设置datagrid的checkbox为禁用状态的方法
Aug 05 #Javascript
基于HTML+CSS+JS实现增加删除修改tab导航特效代码
Aug 05 #Javascript
You might like
PHP的new static和new self的区别与使用
2019/11/27 PHP
js中根据字数截取字符串,不能截断url
2012/01/12 Javascript
jquery如何改变html标签的样式(两种实现方法)
2013/01/16 Javascript
Javacript实现颜色梯度变化和渐变的效果代码
2013/05/31 Javascript
jquery DIV撑大让滚动条滚到最底部代码
2013/06/06 Javascript
Extjs单独定义各组件的实例代码
2013/06/25 Javascript
理运用命名空间让js不产生冲突避免全局变量的泛滥
2014/06/15 Javascript
jQuery中:input选择器用法实例
2015/01/03 Javascript
js关于命名空间的函数实例
2015/02/05 Javascript
jQuery常用且重要方法汇总
2015/07/13 Javascript
javascript创建动态表单的方法
2015/07/25 Javascript
Vue 实用分页paging实例代码
2017/04/12 Javascript
Javascript中的作用域及块级作用域
2017/12/08 Javascript
微信小程序实现倒计时调用相机自动拍照功能
2018/06/10 Javascript
vue 纯js监听滚动条到底部的实例讲解
2018/09/03 Javascript
javascript实现的时间格式加8小时功能示例
2019/06/13 Javascript
vue简单练习 桌面时钟的实现代码实例
2019/09/19 Javascript
vue计算属性无法监听到数组内部变化的解决方案
2019/11/06 Javascript
详解Nuxt.js 实战集锦
2019/11/19 Javascript
决策树的python实现方法
2014/11/18 Python
Python合并同一个文件夹下所有PDF文件的方法
2019/03/11 Python
Django框架model模型对象验证实现方法分析
2019/10/02 Python
python实现小世界网络生成
2019/11/21 Python
python GUI库图形界面开发之PyQt5布局控件QGridLayout详细使用方法与实例
2020/03/06 Python
python3:excel操作之读取数据并返回字典 + 写入的案例
2020/09/01 Python
房地产开发项目建议书
2014/05/16 职场文书
单位法定代表人授权委托书
2014/09/20 职场文书
2014年单位工作总结范文
2014/11/27 职场文书
2015关爱留守儿童工作总结
2014/12/12 职场文书
北京爱情故事观后感
2015/06/12 职场文书
家长会感言
2015/08/01 职场文书
聘任合同书
2015/09/21 职场文书
《陶罐和铁罐》教学反思
2016/03/03 职场文书
导游词之青岛崂山
2019/12/27 职场文书
原生JS中应该禁止出现的写法
2021/05/05 Javascript
在Windows Server 2012上安装 .NET Framework 3.5 所遇到的问题
2022/04/29 Servers