SpringBoot | 第十七章：web 应用开发之文件上传

2018 年 9 月 17 日 ImportNew

（点击上方公众号，可快速关注）

来源：oKong ，

blog.lqdev.cn/2018/08/07/springboot/chapter-seventeen/

前言

上一章节，我们讲解了利用模版引擎实现前端页面渲染，从而实现动态网页的功能，同时也提出了兼容jsp项目的解决方案。既然开始讲解web开发了，我们就接着继续往web这个方向继续吧。通常，我们在做web开发时，碰见诸如附件上传、图片头像上传等文件的上传需求也是再正常不过的。那么，我们今天我们就来讲讲SpringBoot下文件上传的功能的实现。

一点知识

我们知道，前端上传文件时，最常见的就是利用Form表单的方式进行文件的上传功能了，上传时设置enctype为multipart/form-data，或者直接利用jquery的一些上传插件实现。而后端，在jsp+Servlet时代，最常见的就是利用smartupload上传组件。而在SpringMvc时代，其提供了MultipartFile封装类，它包含了文件的二进制流和文件相关属性(文件名、大小等)。所以在SpringBoot中也是使用此封装类进行文件上传的。

文件上传

上面说到，springmvc中是利用MultipartFile进行文件上传的。而MultipartFile是个接口类，它的实现类有CommonsMultipartFile和StandardMultipartFile。这里简单说明下：

StandardMultipartFile：是基于j2ee自带的文件上传进行解析，即使用Servlet3.0提供的javax.servlet.http.Part上传方式。

CommonsMultipartFile：是基于apache fileupload的解析。

所以正常我们使用时，也是无需关系底层是以哪种方式进行文件上传处理的，SpringMvc会给我们做相应的转换的。

这里演示下两种方式。

基于J2EE自带方式

这种方式下，其实无需任何配置。只需按正常的web开发项目集成即可。

0.pom依赖

<dependency>

<groupId>org.springframework.boot</groupId>

<artifactId>spring-boot-starter-web</artifactId>

</dependency>

1.配置文件(可选)，正常只需要设置上传的文件大小

# 最大支持文件大小即单个文件大小

spring.http.multipart.max-file-size=1Mb

# 最大支持请求大小即一次性上传的总文件大小

spring.http.multipart.max-request-size=10Mb

其他的配置，可直接参考官网的配置信息：https://docs.spring.io/spring-boot/docs/1.5.15.RELEASE/reference/htmlsingle/#common-application-properties

2.编写控制类

FileUploadController.java:

@RestController

@Slf4j

public class FileUploadController {

@PostMapping("/upload")

public String upload(@RequestParam MultipartFile file) throws IllegalStateException, IOException {

// 判断是否为空文件

if (file.isEmpty()) {

return "上传文件不能为空";

}

// 文件类型

String contentType = file.getContentType();

// springmvc处理后的文件名

String fileName = file.getName();

log.info("服务器文件名：" + fileName);

// 原文件名即上传的文件名

String origFileName = file.getOriginalFilename();

// 文件大小

Long fileSize = file.getSize();

// 保存文件

// 可以使用二进制流直接保存

// 这里直接使用transferTo

file.transferTo(new File("d://okong-" + origFileName));

return String.format(file.getClass().getName() + "方式文件上传成功！\n文件名:%s,文件类型:%s,文件大小:%s", origFileName, contentType,fileSize);

}

}