SpringBoot --web 应用开发之文件上传

原文出处： oKong

前言

上一章节，咱们讲解了利用模版引擎实现前端页面渲染，从而实现动态网页的功能，同时也提出了兼容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依赖

1 2 3 4

<dependency>      <groupId>org.springframework.boot</groupId>      <artifactId>spring-boot-starter-web</artifactId> </dependency>

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

1 2 3 4

# 最大支持文件大小 即单个文件大小 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:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29

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

3.启动应用，而后使用postman进行api调用便可，固然你们也能够利用上节课学习的模版引擎技术，编写一个文件上传的表单。

基于FileUpload包方式

原来在Springmvc时，咱们一般都是使用CommonsMultipartResolver进行文件上传处理类配置的，好比最大上传文件大小的。而基于在SpringBoot下，略微有些不一样。

0.pom加入fileUpload依赖

1 2 3 4 5

<dependency>      <groupId>commons-fileupload</groupId>      <artifactId>commons-fileupload</artifactId>      <version> 1.3 . 3 </version> </dependency>

1.编写一个配置类
FileUploadConfig.java

1 2 3 4 5 6 7 8

@Configuration public class FileUploadConfig {            @Bean      public MultipartResolver custom() {          return new CommonsMultipartResolver();      } }

2.因为spring.http.multipart.enabled默认是true，因此加载类MultipartAutoConfiguration会自动加载，这样fileUpload就会异常了。因此正常有两种方式：在启动类下将此配置类不进行自动加载

1	@EnableAutoConfiguration (exclude = {MultipartAutoConfiguration. class })

另外一种就是，直接设置spring.http.multipart.enabled为false。
本示例为了两种可切换，使用的是第二种。

3.编写控制层：这个和J2EE的方式是同样的，这里就不贴了。
4.启动应用，使用postman访问下：

相关资料

1. https://docs.spring.io/spring-boot/docs/1.5.15.RELEASE/reference/htmlsingle/

总结

本章节主要是讲解了两种方式来进行文件的上传功能。这里就简单的介绍了两种方式的相关配置和一些注意点，像文件大小过大时进行异常捕获，你们可使用全局异常类来进行捕获，只需捕获MultipartException异常便可，这里就示例了，相对来讲比较简单了。

最后

目前互联网上不少大佬都有SpringBoot系列教程，若有雷同，请多多包涵了。本文是做者在电脑前一字一句敲的，每一步都是实践的。若文中有所错误之处，还望提出，谢谢。

原文地址：http://www.importnew.com/29795.html