Spring Boot 教程 - 文件上传下载

在日常的开发工作中，基本上每个项目都会有各种文件的上传和下载，大多数文件都是excel文件，操作excel的JavaAPI我用的是apache的POI进行操作的，POI我之后会专门讲到。此次我们不讲如何操作文件，只讲如何上传文件和下载文件。

1. 文件的上传

在现在的JavaWeb项目中，与前端进行交互的基本都是SpringMVC框架。Spring专门提供了一个接口MultipartFile，这个接口帮我们简化了从页面到服务端的文件操作，以前我们只能从request里面拿，现在有了这个接口，我们操作起来就会很简单。话不多说，直接上代码。

我们只是模拟文件上传的操作，所以我们从页面上传文件，然后存到电脑桌面。

	@RequestMapping("/upload")
    public void upload(MultipartFile file) throws IOException {
        init(file, 1);
    }

    @RequestMapping("/uploads")
    public void uploads(MultipartFile[] files, DTO dto) throws IOException {
        for (int i = 0; i < files.length; i++) {
            init(files[i], i);
        }
        System.out.println(dto.getParam());
    }

	/**
     * 下载文件初始化
     * @param file 文件
     * @param i 为了区别文件，防止被覆盖
     * @throws IOException
     */
    private void init(MultipartFile file, int i) throws IOException {
        String filename = file.getOriginalFilename();
        OutputStream os = new FileOutputStream(new File("C:\\Users\\WJF\\Desktop" + File.separator + i + filename));
        InputStream is = file.getInputStream();
        StreamUtils.copy(is, os);
        is.close();
        os.close();
    }

上面的代码中，不管是单个文件还是多文件都是很简单的，还可以带其他参数DTO。

2. 文件的下载

文件的下载也是很简单的，但是Response头如果没有设置好，就可能下载失败，下载下来也可能是乱码的。但是这些头设置其实很简单，但是每次下载文件的时候都要这么设置一下，其实是很繁琐的，所以在这里我使用了已经封装好的下载API，直接上代码。

首先我们引入jar包：

<!--springboot父工程-->
    <parent>
        <groupId>org.springframework.boot</groupId>
        <artifactId>spring-boot-starter-parent</artifactId>
        <version>2.2.2.RELEASE</version>
        <relativePath/> <!-- lookup parent from repository -->
    </parent>

    <dependencies>
        <!--springboot框架web组件-->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <!--wjf-download下载小框架，用来简化下载的无味繁琐的操作-->
        <dependency>
            <groupId>red.wjf</groupId>
            <artifactId>wjf-download</artifactId>
            <version>0.1.0.RELEASE</version>
        </dependency>
    </dependencies>

在这里我引入了一个下载的jar包，这个包可以在maven中央仓库直接找到的。这个下载文件jar包的官网地址：传送门

在下载文件之前我们需要配置一下，创建一个下载器，将下载器交给Spring管理：

DownloadConfig.java：

package com.butterflytri.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import red.wjf.download.downloader.ImageDownloader;
import red.wjf.download.downloader.WebDownloader;

/**
 * @author: WJF
 * @date: 2020/7/29
 * @description:  DownloadConfig
 */

@Configuration
public class DownloadConfig {

    @Bean
    public WebDownloader webDownloader() {
        return new WebDownloader();
    }

    @Bean
    public ImageDownloader imageDownloader() {
        return new ImageDownloader();
    }

}

在这里我们创建了两个下载器，都交给了Spring框架管理。

	@RequestMapping("/downloadTest")
    public void download01(HttpServletRequest request, HttpServletResponse response, String fileName) {
        InputStream is = this.getClass().getClassLoader().getResourceAsStream("test.docx");
        try {
            DataWriter writer = new DataWriter(is);
            webDownloader.defaultDownload(request, response, fileName, writer);
        } catch (IOException e) {
            e.printStackTrace();
        }
    }

    @RequestMapping("/downloadImg")
    public void downloadImg(HttpServletRequest request, HttpServletResponse response) {
        InputStream is = this.getClass().getClassLoader().getResourceAsStream("img.jpg");
        ImageWriter writer = new ImageWriter(is, ImgSuffix.JPG);
        imageDownloader.defaultDownload(request, response, writer);
    }

这两个文件(test.docx和img.jpg)都在类路径下，从浏览器页面调用方法，就会下载，不会乱码也不会下载失败，除非文件不存在。jar包还提供了图片的Base64格式下载。在国内我们只需要调用这个默认的下载方法就可以了。下载的演示我就不演示了，大家可以拉下我的代码看看，觉得我写的东西对你有用，也可以给我点个赞哦。

3. 项目地址

本项目传送门：

• GitHub ---> spring-upload-download
• Gitee ---> spring-upload-download

此教程会一直更新下去，觉得博主写的可以的话，关注一下，也可以更方便下次来学习。

---

• 作者：Butterfly-Tri
• 出处：Butterfly-Tri个人博客
• 版权所有，欢迎保留原文链接进行转载