使用Servlet实现文件下载

　　一位朋友最近在学习JavaWeb开发，开始学习文件下载操作，他自己尝试着去网上看一些教程，总的来说也不是太了解，就让我和他说说，如何实现文件下载功能。我和他说了一下大致的思路，主要分为前端和后端两部分来实现文件下载操作。

后台Java代码实现思路：

.1.读取文件信息；

.2.设置返回数据的响应类型为(二进制)流类型;

常见的类型有application/json返回JSON格式的数据;text/html返回html文档数据;application/octet-stream表示返回二进制流数据，文件下载就使用该种方式。

.3.设置响应头信息；注意:文件名有中文需要单独编码;Content-Disposition表示客户端以何种方式来处理返回后台返回的数据，值为"attachment"表示作为附件下载;

.4.获取文件输入流和响应对象输出流使用try()的语法不用手动关闭输入输出流；

.5.将输入流写入到响应输出流中；

.6.刷新缓冲区数据；

前端html实现思路：

.1.方式一:使用window.location.href=请求地址;

.2.方式二:使用 window.open(请求地址);

.3.方式三:动态创建一个a标签，然后设置a标签的href属性为请求地址，手动触发单击click()事件;

.4.方式四:直接写一个a标签，href属性设置为请求地址，点击即可。

前端页面实现起来比较简单，主要是发送一个请求到后台即可。

后端示例代码实现如下:

@WebServlet("/fileDownLoad")
public class FileDownLoadTest extends HttpServlet {
   @Override
   public void doGet(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response) throws javax.servlet.ServletException, java.io.IOException {
       // 1.读取文件信息
       File file = new File("D:\\JavaWorkSpace\\course2024\\maven-demo\\src\\main\\webapp\\bg.png");
       String fileName = file.getName();
       // 2.设置返回数据的响应类型为(二进制)流类型
       response.setContentType("application/octet-stream");
       // 3.设置响应头信息告诉浏览器以何种方式处理后台返回的数据；attachment 表示浏览器以下载的形式打开文件
       // 文件名有中文需要单独编码
       String encodedFilename = URLEncoder.encode(fileName, "UTF-8");
       response.setHeader("Content-Disposition", "inline;filename=" + encodedFilename);
       // 4.获取文件输入流和响应对象输出流使用try()的语法不用手动关闭输入输出流
       // 使用添加了 Bufferd 的文件处理类效率会更高一些
       try(BufferedInputStream bis = new BufferedInputStream(new FileInputStream(file));
           BufferedOutputStream bos = new BufferedOutputStream(response.getOutputStream()); ){
           // 5.将输入流写入到响应输出流中
           int len;
           byte[] bytes = new byte[1024];
           while ((len = bis.read(bytes)) != -1) {
               bos.write(bytes, 0, len);
           }
           // 6.刷新缓冲区数据
           bos.flush();
       } catch (Exception e){
           e.printStackTrace();
       }

       System.out.println("文件下载完成!");
   }
}

前端示例代码如下：

<!DOCTYPE html>

<head>

<title>Title</title>

</head>

<body>

<button onclick="downloadTest()">location-方式下载</button><br>

<button onclick="downloadTest2()">open-签方式下载</button><br>

<button onclick="downloadTest3()">a-签方式下载</button><br>

<a href="http://localhost:8080/maven-demo/fileDownLoad">a签方点击下载</a><br>

</body>

</html>

function downloadTest() {

window.location.href = "http://localhost:8080/maven-demo/fileDownLoad";

}

function downloadTest2() {

window.open("http://localhost:8080/maven-demo/fileDownLoad");

}

function downloadTest3() {

var a = document.createElement("a");

a.href = "http://localhost:8080/maven-demo/fileDownLoad";

a.click();

}

</script>

最终测试效果如下，

测试方式一：可以直接在浏览器中放入请求地址，然后点击回车键即可。

测试方式二：使用调试工具，比如apiFox；发送请求后，会将文件暂存在工具中，需要手动下载。

测试三：打开下载页面，点击任意一个下载链接，即可完成文件的下载。

至此：文件下载的功能全部完成。说明：Java代码中，在进行I/O流操作时，能使用带buffer缓冲区的类尽量使用，因为它的效率会高很多。性能相关可参考博客：

https://blog.csdn.net/qq_32099833/article/details/109002715