定制软件SpringBoot实现文件上传和下载

1.用IDEA创建名叫springboot-file的SpringBoot项目，并将Package name 改为com.example.springboot，导入Spring Web和thymeleaf依赖。（定制软件如果创建过程中遇到了问题，定制软件可以看我写的文章《》定制软件中前三个步骤。）

  1. <dependency>
  2.   <groupId>org.springframework.boot</groupId>
  3.   <artifactId>spring-boot-starter-web</artifactId>
  4. </dependency>
  5. <dependency>
  6.   <groupId>org.springframework.boot</groupId>
  7.   <artifactId>spring-boot-starter-thymeleaf</artifactId>
  8. </dependency>

2.定制软件文件上传分为单文件上定制软件传和多文件上传，定制软件这里通过一个方法实现。在src/main/resources/templates定制软件文件下创建upload.html文件。

  1. <!DOCTYPE html>
  2. <html xmlns:th="http://www.thymeleaf.org">
  3. <head>
  4.  
  5. </head>
  6.  
  7. <body>
  8.     <form th:action="@{/upload}" method="post" enctype="multipart/form-data">
  9.         定制软件选择单个文件<input type="file" name="file"><br><br>
  10.         定制软件选择多个文件<input type="file" name="files" multiple><br><br>
  11.         <input type="submit" value="上传">
  12.     </form>
  13. </body>
  14.  
  15. </html>

3.在src/main/resources文件下的application.properties文件中，定制软件添加文件保存的路径。

filePath=E:/springboot_save_file/

4.在src/main/resources的com.example.springboot文件夹下，创建包controller，并创建FileController类，定制软件用于处理所有的文件上定制软件传和下载请求。（定制软件由于下载页面还没写，定制软件所以上传文件完成后，会报404错误，定制软件但是不影响功能）

  1. package com.example.springboot.controller;
  2.  
  3. import cn.hutool.extra.servlet.ServletUtil;
  4. import lombok.extern.slf4j.Slf4j;
  5. import org.springframework.beans.factory.annotation.Value;
  6. import org.springframework.stereotype.Controller;
  7. import org.springframework.ui.Model;
  8. import org.springframework.web.bind.annotation.*;
  9. import org.springframework.web.multipart.MultipartFile;
  10.  
  11. import javax.servlet.http.HttpServletResponse;
  12. import java.io.File;
  13. import java.io.FileInputStream;
  14. import java.io.IOException;
  15. import java.io.OutputStream;
  16. import java.nio.CharBuffer;
  17. import java.nio.charset.Charset;
  18. import java.nio.charset.CharsetEncoder;
  19. import java.util.List;
  20.  
  21. @Controller
  22. public class FileController {
  23. 	//读取application.properties文件中的filePath属性
  24.     @Value("${filePath}")
  25.     private String filePath;
  26.  
  27.     /**
  28.      * 定制软件前往上传页面
  29.      * @return 页面名称
  30.      */
  31.     @GetMapping({"/upload", ""})
  32.     public String goIndex() {
  33.         return "upload";
  34.     }
  35.  
  36.     /**
  37.      *  定制软件将文件保存到指定文件夹
  38.      * @param file  单个文件
  39.      * @param files 多个文件
  40.      * @return      重定向到controller定制软件层中定制软件前往下载页面的url
  41.      * @throws IOException
  42.      */
  43.     @PostMapping("/upload")
  44.     public String uploadAndGoDownLoad(@RequestPart("file") MultipartFile file,
  45.                                       @RequestPart("files") List<MultipartFile> files) throws IOException {
  46.  
  47.  
  48.         //定制软件定制软件判断文件夹是否存在，不存在时，定制软件创建文件夹
  49.         File directoryFile = new File(filePath);
  50.         if (!directoryFile.exists()) {
  51.             //定制软件创建多个文件夹
  52.             directoryFile.mkdirs();
  53.         }
  54.  
  55.         //定制软件判断文件是否为空，不为空时，保存文件
  56.         if (!file.isEmpty()) {
  57.             saveFile(file);
  58.         }
  59.  
  60.         //定制软件判断上传文件个数是否为0
  61.         if (files.size() > 0) {
  62.             for (MultipartFile multipartFile : files) {
  63.                 if (!multipartFile.isEmpty()) {
  64.                     saveFile(multipartFile);
  65.                 }
  66.             }
  67.         }
  68.         return "redirect:/goDownload";
  69.     }
  70.  
  71.     /**
  72.      * 定制软件保存所有的所有上传的文件名称，前往下载页面
  73.      * @param model
  74.      * @return 页面名称
  75.      */
  76.     @GetMapping("/goDownload")
  77.     public String goDownload(Model model) {
  78.         File file = new File(filePath);
  79.         //判断文件夹是否存在
  80.         if (file.exists()) {
  81.             //获取文件夹下面的所有名称
  82.             String[] list = file.list();
  83.             model.addAttribute("fileNames", list);
  84.         }
  85.  
  86.         return "download";
  87.     }
  88.  
  89.     /**
  90.      * 保存文件到指定位置
  91.      * @param file 需要上传的文件
  92.      * @throws IOException
  93.      */
  94.     public void saveFile(MultipartFile file) throws IOException {
  95.         //获取文件名
  96.         String name = file.getOriginalFilename();
  97.         file.transferTo(new File(filePath + name));
  98.     }
  99. }

注意：

1.前端向后端传递的form表单enctype属性的值必须"multipart/form-data。

2.前后端请求方式要一致，且必须为post。

3.@RequestPart注解最好加上，但是不加也可以。注意前后端参数的绑定，对于注解的使用，可以查看我写的《》。

结果：

5.对于文件上传功能，相对较为简单，这里就不具体说了。下面会具体介绍文件下载，前后端实现方式和注意的地方。文件下载和文件上传是连在一起的，都写在了FileController类中。首先前端写采用最简单的方式，实现文件下载，将后端实现方式讲完后，再讲其他前端实现方式。

  1. <!DOCTYPE html>
  2. <html xmlns:th="http://www.thymeleaf.org">
  3.  
  4.   <head>
  5.     <script>
  6.       function downloadFileByOpen(fileName) {
  7.         window.open("http://localhost:8080/download/hutool?fileName=" + fileName);
  8.       }
  9.     </script>
  10.   </head>
  11.  
  12.   <body>
  13.     <h3>后端hutool + 前端open方式</h3>
  14.     <div th:if="${fileNames} == null">没有文件可下载</div>
  15.     <ul>
  16.       <li th:each="fileName : ${fileNames}" th:text="${fileName} + '  下载'" th:onclick="downloadFileByOpen([[${fileName}]])">
  17.       </li>
  18.     </ul>
  19.  
  20.  
  21.   </body>
  22.  
  23. </html>

6.后端实现文件下载方式一：hutool方式。在pom.xml文件中导入hutool-extra的依赖，并设置CharacterEncoding为UTF-8。如果不设置CharacterEncoding，会出现中文文件名乱码。

  1. <dependency>
  2.   <groupId>cn.hutool</groupId>
  3.   <artifactId>hutool-extra</artifactId>
  4.   <version>5.8.8</version>
  5. </dependency>
  1. package com.example.springboot.controller;
  2.  
  3. import cn.hutool.extra.servlet.ServletUtil;
  4. import lombok.extern.slf4j.Slf4j;
  5. import org.springframework.beans.factory.annotation.Value;
  6. import org.springframework.stereotype.Controller;
  7. import org.springframework.ui.Model;
  8. import org.springframework.web.bind.annotation.*;
  9. import org.springframework.web.multipart.MultipartFile;
  10.  
  11. import javax.servlet.http.HttpServletResponse;
  12. import java.io.File;
  13. import java.io.FileInputStream;
  14. import java.io.IOException;
  15. import java.io.OutputStream;
  16. import java.nio.CharBuffer;
  17. import java.nio.charset.Charset;
  18. import java.nio.charset.CharsetEncoder;
  19. import java.util.List;
  20.  
  21. @Controller
  22. public class FileController {
  23. 	//读取application.properties文件中的filePath属性
  24.     @Value("${filePath}")
  25.     private String filePath;
  26.  
  27.     /**
  28.      * 前往上传页面
  29.      * @return 页面名称
  30.      */
  31.     @GetMapping({"/upload", ""})
  32.     public String goIndex() {
  33.         return "upload";
  34.     }
  35.  
  36.     /**
  37.      *  将文件保存到指定文件夹
  38.      * @param file  单个文件
  39.      * @param files 多个文件
  40.      * @return      重定向到controller层中前往下载页面的url
  41.      * @throws IOException
  42.      */
  43.     @PostMapping("/upload")
  44.     public String uploadAndGoDownLoad(@RequestPart("file") MultipartFile file,
  45.                                       @RequestPart("files") List<MultipartFile> files) throws IOException {
  46.  
  47.  
  48.         //判断文件夹是否存在，不存在时，创建文件夹
  49.         File directoryFile = new File(filePath);
  50.         if (!directoryFile.exists()) {
  51.             //创建多个文件夹
  52.             directoryFile.mkdirs();
  53.         }
  54.  
  55.         //判断文件是否为空，不为空时，保存文件
  56.         if (!file.isEmpty()) {
  57.             saveFile(file);
  58.         }
  59.  
  60.         //判断上传文件个数是否为0
  61.         if (files.size() > 0) {
  62.             for (MultipartFile multipartFile : files) {
  63.                 if (!multipartFile.isEmpty()) {
  64.                     saveFile(multipartFile);
  65.                 }
  66.             }
  67.         }
  68.         return "redirect:/goDownload";
  69.     }
  70.  
  71.     /**
  72.      * 保存所有的所有上传的文件名称，前往下载页面
  73.      * @param model
  74.      * @return 页面名称
  75.      */
  76.     @GetMapping("/goDownload")
  77.     public String goDownload(Model model) {
  78.         File file = new File(filePath);
  79.         //判断文件夹是否存在
  80.         if (file.exists()) {
  81.             //获取文件夹下面的所有名称
  82.             String[] list = file.list();
  83.             model.addAttribute("fileNames", list);
  84.         }
  85.  
  86.         return "download";
  87.     }
  88.  
  89.      /**
  90.      * 使用Hutool实现文件下载
  91.      * @param fileName 要下载的文件名
  92.      * @param response
  93.      */
  94.     @GetMapping("/download/hutool")
  95.     @ResponseBody
  96.     public void downloadByHutool(@RequestParam(value = "fileName") String fileName,
  97.                                  HttpServletResponse response) {
  98.         //防止中文乱码
  99.         response.setCharacterEncoding("UTF-8");
  100.         ServletUtil.write(response,new File(filePath + fileName));
  101.     }
  102.  
  103.     /**
  104.      * 保存文件到指定位置
  105.      * @param file 需要上传的文件
  106.      * @throws IOException
  107.      */
  108.     public void saveFile(MultipartFile file) throws IOException {
  109.         //获取文件名
  110.         String name = file.getOriginalFilename();
  111.         file.transferTo(new File(filePath + name));
  112.     }
  113. }

7.后端实现方式二：通过查看Hutool源码，自己模仿着源码写的一种方式。将前端download.html文件中，添加方式二的测试。后端添加方式二的实现代码

  1. <!DOCTYPE html>
  2. <html xmlns:th="http://www.thymeleaf.org">
  3.  
  4. <head>
  5.     <script>
  6.         function downloadFileByOpen(fileName) {
  7.             window.open("http://localhost:8080/download/hutool?fileName=" + fileName);
  8.         }
  9.         function downloadFileByOpenAndSelf(fileName) {
  10.             window.open("http://localhost:8080/download/hutool/self?fileName=" + fileName);
  11.         }
  12.     </script>
  13. </head>
  14.  
  15. <body>
  16.     <h3>后端hutool + 前端open方式</h3>
  17.     <div th:if="${fileNames} == null">没有文件可下载</div>
  18.     <ul>
  19.         <li th:each="fileName : ${fileNames}" th:text="${fileName} + '  下载'" th:onclick="downloadFileByOpen([[${fileName}]])">
  20.         </li>
  21.     </ul>
  22.     <br>
  23.     <br>
  24.  
  25.     <h3>后端模仿hutool + 前端open方式</h3>
  26.         <div th:if="${fileNames} == null">没有文件可下载</div>
  27.         <ul>
  28.             <li th:each="fileName : ${fileNames}" th:text="${fileName} + '  下载'" th:onclick="downloadFileByOpenAndSelf([[${fileName}]])">
  29.             </li>
  30.         </ul>
  31.  
  32. </body>
  33.  
  34. </html>
  1. package com.example.springboot.controller;
  2.  
  3. import cn.hutool.extra.servlet.ServletUtil;
  4. import lombok.extern.slf4j.Slf4j;
  5. import org.springframework.beans.factory.annotation.Value;
  6. import org.springframework.stereotype.Controller;
  7. import org.springframework.ui.Model;
  8. import org.springframework.web.bind.annotation.*;
  9. import org.springframework.web.multipart.MultipartFile;
  10.  
  11. import javax.servlet.http.HttpServletResponse;
  12. import java.io.File;
  13. import java.io.FileInputStream;
  14. import java.io.IOException;
  15. import java.io.OutputStream;
  16. import java.nio.CharBuffer;
  17. import java.nio.charset.Charset;
  18. import java.nio.charset.CharsetEncoder;
  19. import java.util.List;
  20.  
  21. @Controller
  22. public class FileController {
  23. 	//读取application.properties文件中的filePath属性
  24.     @Value("${filePath}")
  25.     private String filePath;
  26.  
  27.     /**
  28.      * 前往上传页面
  29.      * @return 页面名称
  30.      */
  31.     @GetMapping({"/upload", ""})
  32.     public String goIndex() {
  33.         return "upload";
  34.     }
  35.  
  36.     /**
  37.      *  将文件保存到指定文件夹
  38.      * @param file  单个文件
  39.      * @param files 多个文件
  40.      * @return      重定向到controller层中前往下载页面的url
  41.      * @throws IOException
  42.      */
  43.     @PostMapping("/upload")
  44.     public String uploadAndGoDownLoad(@RequestPart("file") MultipartFile file,
  45.                                       @RequestPart("files") List<MultipartFile> files) throws IOException {
  46.  
  47.  
  48.         //判断文件夹是否存在，不存在时，创建文件夹
  49.         File directoryFile = new File(filePath);
  50.         if (!directoryFile.exists()) {
  51.             //创建多个文件夹
  52.             directoryFile.mkdirs();
  53.         }
  54.  
  55.         //判断文件是否为空，不为空时，保存文件
  56.         if (!file.isEmpty()) {
  57.             saveFile(file);
  58.         }
  59.  
  60.         //判断上传文件个数是否为0
  61.         if (files.size() > 0) {
  62.             for (MultipartFile multipartFile : files) {
  63.                 if (!multipartFile.isEmpty()) {
  64.                     saveFile(multipartFile);
  65.                 }
  66.             }
  67.         }
  68.         return "redirect:/goDownload";
  69.     }
  70.  
  71.     /**
  72.      * 保存所有的所有上传的文件名称，前往下载页面
  73.      * @param model
  74.      * @return 页面名称
  75.      */
  76.     @GetMapping("/goDownload")
  77.     public String goDownload(Model model) {
  78.         File file = new File(filePath);
  79.         //判断文件夹是否存在
  80.         if (file.exists()) {
  81.             //获取文件夹下面的所有名称
  82.             String[] list = file.list();
  83.             model.addAttribute("fileNames", list);
  84.         }
  85.  
  86.         return "download";
  87.     }
  88.  
  89.      /**
  90.      * 使用Hutool实现文件下载
  91.      * @param fileName 要下载的文件名
  92.      * @param response
  93.      */
  94.     @GetMapping("/download/hutool")
  95.     @ResponseBody
  96.     public void downloadByHutool(@RequestParam(value = "fileName") String fileName,
  97.                                  HttpServletResponse response) {
  98.         //防止中文乱码
  99.         response.setCharacterEncoding("UTF-8");
  100.         ServletUtil.write(response,new File(filePath + fileName));
  101.     }
  102.  
  103.     /**
  104.      * 模仿hutool实现文件下载
  105.      * @param fileName 要下载的文件名
  106.      * @param response
  107.      * @throws IOException
  108.      */
  109.     @GetMapping("/download/hutool/self")
  110.     @ResponseBody
  111.     public void downloadBySelfAndHutool(@RequestParam(value = "fileName") String fileName,
  112.                                         HttpServletResponse response) throws IOException {
  113.  
  114.         //设置字符编码
  115.         response.setCharacterEncoding("UTF-8");
  116.  
  117.         //以下模仿hutool进行相应设置
  118.         //设置内容类型
  119.         response.setHeader("Content-Type", "application/octet-stream");
  120.         //设置文件名，是解决中文乱码的关键
  121.         response.setHeader("Content-Disposition", String.format("attachment;filename=\"%s\"", URLEncoder.encode(fileName,"UTF-8")));
  122.  
  123.         //将文件取出，并写到response
  124.         FileInputStream fileInputStream = new FileInputStream(filePath + fileName);
  125.         OutputStream outputStream = response.getOutputStream();
  126.         byte[] bytes = new byte[1024];
  127.         int length;
  128.         while ((length = fileInputStream.read(bytes)) != -1) {
  129.             outputStream.write(bytes, 0, length);
  130.         }
  131.         fileInputStream.close();
  132.         outputStream.flush();
  133.         outputStream.close();
  134.     }
  135.  
  136.     /**
  137.      * 保存文件到指定位置
  138.      * @param file 需要上传的文件
  139.      * @throws IOException
  140.      */
  141.     public void saveFile(MultipartFile file) throws IOException {
  142.         //获取文件名
  143.         String name = file.getOriginalFilename();
  144.         file.transferTo(new File(filePath + name));
  145.     }
  146. }

8.上面两种后端实现文件下载方式，对于前端来说，无论是通过open方式，还是通过方式都可以使用。下面这种是通过返回值方式，这种方式主要用于前后端分离项目中。下面以原生的Ajax，模拟前后端分离项目，介绍前后端的实现方式。

download.html中添加Ajax和返回值方式实现文件下载的测试。

  1. <!DOCTYPE html>
  2. <html xmlns:th="http://www.thymeleaf.org">
  3.  
  4. <head>
  5.     <script>
  6.         function downloadFileByOpen(fileName) {
  7.             window.open("http://localhost:8080/download/hutool?fileName=" + fileName);
  8.         }
  9.         function downloadFileByOpenAndSelf(fileName) {
  10.             window.open("http://localhost:8080/download/hutool/self?fileName=" + fileName);
  11.         }
  12.         function downloadFileByAjax(fileName) {
  13.             let xhr = new XMLHttpRequest;
  14.             xhr.open("get","/download/return?fileName=" + fileName,true);
  15.             //发送请求
  16.             xhr.send();
  17.             xhr.responseType="blob";
  18.             xhr.onload = function() {
  19.                 if(this.status === 200) {
  20.                     let blob = new Blob([this.response]);
  21.                     let elink = document.createElement('a');
  22.                     elink.download = fileName;
  23.                     elink.style.display = 'none';
  24.                     elink.href = URL.createObjectURL(blob);
  25.                     document.body.appendChild(elink);
  26.                     elink.click();
  27.                     // 释放URL 对象
  28.                     URL.revokeObjectURL(elink.href);
  29.                     document.body.removeChild(elink);
  30.                 }
  31.             }
  32.         }
  33.     </script>
  34. </head>
  35.  
  36. <body>
  37.     <h3>后端hutool + 前端open方式</h3>
  38.     <div th:if="${fileNames} == null">没有文件可下载</div>
  39.     <ul>
  40.         <li th:each="fileName : ${fileNames}" th:text="${fileName} + '  下载'"
  41.             th:onclick="downloadFileByOpen([[${fileName}]])">
  42.         </li>
  43.     </ul>
  44.     <br>
  45.     <br>
  46.  
  47.     <h3>后端模仿hutool + 前端open方式</h3>
  48.     <div th:if="${fileNames} == null">没有文件可下载</div>
  49.     <ul>
  50.         <li th:each="fileName : ${fileNames}" th:text="${fileName} + '  下载'"
  51.             th:onclick="downloadFileByOpenAndSelf([[${fileName}]])">
  52.         </li>
  53.     </ul>
  54.     <br>
  55.     <br>
  56.  
  57.     <h3>后端返回值 + 前端Ajax方式</h3>
  58.     <div th:if="${fileNames} == null">没有文件可下载</div>
  59.     <ul>
  60.         <li th:each="fileName : ${fileNames}" th:text="${fileName} + '  下载'"
  61.             th:onclick="downloadFileByAjax([[${fileName}]])">
  62.         </li>
  63.     </ul>
  64. </body>
  65.  
  66. </html>

FileController类中添加返回值方式实现文件上传的代码。（FileController类最终代码）

  1. package com.example.springboot.controller;
  2.  
  3. import cn.hutool.extra.servlet.ServletUtil;
  4. import lombok.extern.slf4j.Slf4j;
  5. import org.springframework.beans.factory.annotation.Value;
  6. import org.springframework.stereotype.Controller;
  7. import org.springframework.ui.Model;
  8. import org.springframework.web.bind.annotation.*;
  9. import org.springframework.web.multipart.MultipartFile;
  10.  
  11. import javax.servlet.http.HttpServletResponse;
  12. import java.io.File;
  13. import java.io.FileInputStream;
  14. import java.io.IOException;
  15. import java.io.OutputStream;
  16. import java.nio.CharBuffer;
  17. import java.nio.charset.Charset;
  18. import java.nio.charset.CharsetEncoder;
  19. import java.util.List;
  20.  
  21. @Controller
  22. public class FileController {
  23. 	//读取application.properties文件中的filePath属性
  24.     @Value("${filePath}")
  25.     private String filePath;
  26.  
  27.     /**
  28.      * 前往上传页面
  29.      * @return 页面名称
  30.      */
  31.     @GetMapping({"/upload", ""})
  32.     public String goIndex() {
  33.         return "upload";
  34.     }
  35.  
  36.     /**
  37.      *  将文件保存到指定文件夹
  38.      * @param file  单个文件
  39.      * @param files 多个文件
  40.      * @return      重定向到controller层中前往下载页面的url
  41.      * @throws IOException
  42.      */
  43.     @PostMapping("/upload")
  44.     public String uploadAndGoDownLoad(@RequestPart("file") MultipartFile file,
  45.                                       @RequestPart("files") List<MultipartFile> files) throws IOException {
  46.  
  47.  
  48.         //判断文件夹是否存在，不存在时，创建文件夹
  49.         File directoryFile = new File(filePath);
  50.         if (!directoryFile.exists()) {
  51.             //创建多个文件夹
  52.             directoryFile.mkdirs();
  53.         }
  54.  
  55.         //判断文件是否为空，不为空时，保存文件
  56.         if (!file.isEmpty()) {
  57.             saveFile(file);
  58.         }
  59.  
  60.         //判断上传文件个数是否为0
  61.         if (files.size() > 0) {
  62.             for (MultipartFile multipartFile : files) {
  63.                 if (!multipartFile.isEmpty()) {
  64.                     saveFile(multipartFile);
  65.                 }
  66.             }
  67.         }
  68.         return "redirect:/goDownload";
  69.     }
  70.  
  71.     /**
  72.      * 保存所有的所有上传的文件名称，前往下载页面
  73.      * @param model
  74.      * @return 页面名称
  75.      */
  76.     @GetMapping("/goDownload")
  77.     public String goDownload(Model model) {
  78.         File file = new File(filePath);
  79.         //判断文件夹是否存在
  80.         if (file.exists()) {
  81.             //获取文件夹下面的所有名称
  82.             String[] list = file.list();
  83.             model.addAttribute("fileNames", list);
  84.         }
  85.  
  86.         return "download";
  87.     }
  88.  
  89.      /**
  90.      * 使用Hutool实现文件下载
  91.      * @param fileName 要下载的文件名
  92.      * @param response
  93.      */
  94.     @GetMapping("/download/hutool")
  95.     @ResponseBody
  96.     public void downloadByHutool(@RequestParam(value = "fileName") String fileName,
  97.                                  HttpServletResponse response) {
  98.         //防止中文乱码
  99.         response.setCharacterEncoding("UTF-8");
  100.         ServletUtil.write(response,new File(filePath + fileName));
  101.     }
  102.  
  103.     /**
  104.      * 模仿hutool实现文件下载
  105.      * @param fileName 要下载的文件名
  106.      * @param response
  107.      * @throws IOException
  108.      */
  109.     @GetMapping("/download/hutool/self")
  110.     @ResponseBody
  111.     public void downloadBySelfAndHutool(@RequestParam(value = "fileName") String fileName,
  112.                                         HttpServletResponse response) throws IOException {
  113.  
  114.         //设置字符编码
  115.         response.setCharacterEncoding("UTF-8");
  116.  
  117.         //以下模仿hutool进行相应设置
  118.         //设置内容类型
  119.         response.setHeader("Content-Type", "application/octet-stream");
  120.         //设置文件名，是解决中文乱码的关键
  121.         response.setHeader("Content-Disposition", String.format("attachment;filename=\"%s\"", URLEncoder.encode(fileName,"UTF-8")));
  122.  
  123.         //将文件取出，并写到response
  124.         FileInputStream fileInputStream = new FileInputStream(filePath + fileName);
  125.         OutputStream outputStream = response.getOutputStream();
  126.         byte[] bytes = new byte[1024];
  127.         int length;
  128.         while ((length = fileInputStream.read(bytes)) != -1) {
  129.             outputStream.write(bytes, 0, length);
  130.         }
  131.         fileInputStream.close();
  132.         outputStream.flush();
  133.         outputStream.close();
  134.     }
  135.  
  136.      /**
  137.      * 通过返回值方式，实现文件下载
  138.      * @param fileName  文件名
  139.      * @return  文件流和请求头信息
  140.      * @throws IOException
  141.      */
  142.     @GetMapping("/download/return")
  143.     @ResponseBody
  144.     public ResponseEntity<InputStreamResource> download(@RequestParam(value = "fileName") String fileName) throws IOException {
  145.         // 读取文件
  146.         String path = filePath + fileName;
  147.         FileSystemResource file = new FileSystemResource(path);
  148.  
  149.         // 设置响应头
  150.         HttpHeaders headers = new HttpHeaders();
  151.         headers.add("Content-Disposition", String.format("attachment; filename=\"%s\"", file.getFilename()));
  152.  
  153.         return ResponseEntity
  154.                 .ok()
  155.                 .headers(headers)
  156.                 .contentLength(file.contentLength())
  157.                 .contentType(MediaType.parseMediaType("application/octet-stream"))
  158.                 .body(new InputStreamResource(file.getInputStream()));
  159.     }
  160.  
  161.     /**
  162.      * 保存文件到指定位置
  163.      * @param file 需要上传的文件
  164.      * @throws IOException
  165.      */
  166.     public void saveFile(MultipartFile file) throws IOException {
  167.         //获取文件名
  168.         String name = file.getOriginalFilename();
  169.         file.transferTo(new File(filePath + name));
  170.     }
  171. }

注意：

1.前端采用原生的ajax实现的，responseType最好设置为blob（设置为arraybuffer也可以，就是增加转换为blob的步骤）。（开始打算用jQuery中的ajax，但是设置responseType为blob会报错。查找原因，也解决不了。一般这种后端实现方式，对应的是前后端分离项目，然后前端使用的axios。我的能力也有限，知道解决方式的可以评论区留言，一起进步。

报错：jquery.js:10287 Uncaught DOMException: Failed to read the 'responseText' property from 'XMLHttpRequest': The value is only accessible if the object's 'responseType' is '' or 'text' (was 'blob').）

2.查看后端代码可以发现，这种下载文件的方式，我们不用去考虑中文乱码问题了。

9.前端使用，后端继续使用返回值方式，实现文件下载功能。以下是download.html最终代码。后端代码没有改变。这种前后端配合方式实现文件下载，在前后端分离项目中应用广泛（尤其在vue+springboot前后端组合中）。

  1. <!DOCTYPE html>
  2. <html xmlns:th="http://www.thymeleaf.org">
  3.  
  4. <head>
  5.     <!-- 导入axios -->
  6.     <script src="https://unpkg.com/axios/dist/axios.min.js"></script>
  7.     <script>
  8.         function downloadFileByOpen(fileName) {
  9.             window.open("http://localhost:8080/download/hutool?fileName=" + fileName);
  10.         }
  11.         function downloadFileByOpenAndSelf(fileName) {
  12.             window.open("http://localhost:8080/download/hutool/self?fileName=" + fileName);
  13.         }
  14.         function downloadFileByAjax(fileName) {
  15.             let xhr = new XMLHttpRequest;
  16.             xhr.open("get", "/download/return?fileName=" + fileName, true);
  17.             //发送请求
  18.             xhr.send();
  19.             xhr.responseType = "blob";
  20.             xhr.onload = function () {
  21.                 if (this.status === 200) {
  22.                     let blob = new Blob([this.response]);
  23.                     let elink = document.createElement('a');
  24.                     elink.download = fileName;
  25.                     elink.style.display = 'none';
  26.                     elink.href = URL.createObjectURL(blob);
  27.                     document.body.appendChild(elink);
  28.                     elink.click();
  29.                     // 释放URL 对象
  30.                     URL.revokeObjectURL(elink.href);
  31.                     document.body.removeChild(elink);
  32.                 }
  33.             }
  34.         }
  35.         function downloadFileByAxios(fileName) {
  36.             axios({
  37.                 url: "/download/return",
  38.                 method: "get",
  39.                 responseType: "blob",
  40.                 params: {
  41.                     fileName
  42.                 }
  43.             }).then(function (res) {
  44.                 console.log(res);
  45.                 let blob = new Blob([res.data]);
  46.                 let elink = document.createElement('a');
  47.                 elink.download = fileName;
  48.                 elink.style.display = 'none';
  49.                 elink.href = URL.createObjectURL(blob);
  50.                 document.body.appendChild(elink);
  51.                 elink.click();
  52.                 // 释放URL 对象
  53.                 URL.revokeObjectURL(elink.href);
  54.                 document.body.removeChild(elink);
  55.             })
  56.         }
  57.     </script>
  58. </head>
  59.  
  60. <body>
  61.     <h3>后端hutool + 前端open方式</h3>
  62.     <div th:if="${fileNames} == null">没有文件可下载</div>
  63.     <ul>
  64.         <li th:each="fileName : ${fileNames}" th:text="${fileName} + '  下载'"
  65.             th:onclick="downloadFileByOpen([[${fileName}]])">
  66.         </li>
  67.     </ul>
  68.     <br>
  69.     <br>
  70.  
  71.     <h3>后端模仿hutool + 前端open方式</h3>
  72.     <div th:if="${fileNames} == null">没有文件可下载</div>
  73.     <ul>
  74.         <li th:each="fileName : ${fileNames}" th:text="${fileName} + '  下载'"
  75.             th:onclick="downloadFileByOpenAndSelf([[${fileName}]])">
  76.         </li>
  77.     </ul>
  78.     <br>
  79.     <br>
  80.  
  81.     <h3>后端返回值 + 前端Ajax方式</h3>
  82.     <div th:if="${fileNames} == null">没有文件可下载</div>
  83.     <ul>
  84.         <li th:each="fileName : ${fileNames}" th:text="${fileName} + '  下载'"
  85.             th:onclick="downloadFileByAjax([[${fileName}]])">
  86.         </li>
  87.     </ul>
  88.     <br>
  89.     <br>
  90.     
  91.     <h3>后端返回值 + 前端axios方式</h3>
  92.     <div th:if="${fileNames} == null">没有文件可下载</div>
  93.     <ul>
  94.         <li th:each="fileName : ${fileNames}" th:text="${fileName} + '  下载'"
  95.             th:onclick="downloadFileByAxios([[${fileName}]])">
  96.         </li>
  97.     </ul>
  98. </body>
  99.  
  100. </html>

SpringBoot实现文件上传和下载部分，到此结束了。我也是个新手，上面很多内容不够完善，甚至有些是错误的，请大家见谅。这是我在学习过程中做的笔记，感觉对大家可能有所帮助才发出来的，大家可以选择性查看。我也是在不断学习，不断完善自己。如果我在学习过程中，感觉对大家有用的部分，也会再次分享给大家的。谢谢！

上面有个问题还没有解决，也就是，前端怎么通过JQuery中的Ajax实现文件下载。这种方式和原生Ajax区别不大，下面就是代码，只需要设置返回类型为blob即可。（有时候，一个小问题，如果不熟悉，真的很难解决的。。。）

  1. $.ajax({
  2.   type: "get",
  3.   url: "/download/return",
  4.   data: {
  5.     fileName
  6.   },
  7.   xhrFields: { responseType: "blob" },
  8.   success: function (response) {
  9.     let blob = new Blob([response]);
  10.     let elink = document.createElement('a');
  11.     elink.download = fileName;
  12.     elink.style.display = 'none';
  13.     elink.href = URL.createObjectURL(blob);
  14.     document.body.appendChild(elink);
  15.     elink.click();
  16.     // 释放URL 对象
  17.     URL.revokeObjectURL(elink.href);
  18.     document.body.removeChild(elink);
  19.   }
  20. });

网站建设定制开发 软件系统开发定制 定制软件开发 软件开发定制 定制app开发 app开发定制 app开发定制公司 电商商城定制开发 定制小程序开发 定制开发小程序 客户管理系统开发定制 定制网站 定制开发 crm开发定制 开发公司 小程序开发定制 定制软件 收款定制开发 企业网站定制开发 定制化开发 android系统定制开发 定制小程序开发费用 定制设计 专注app软件定制开发 软件开发定制定制 知名网站建设定制 软件定制开发供应商 应用系统定制开发 软件系统定制开发 企业管理系统定制开发 系统定制开发