Spring之配置multipartResolver解析器、上传文件、处理文件过程

 更新时间:2025年08月08日 09:47:33   作者:CrazyIdeas  
文章介绍了Spring中处理multipart表单的两种解析器(CommonsMultipartResolver和StandardServletMultipartResolver)的配置方法,包括文件大小限制、临时存储路径设置,以及通过enctype和accept属性控制上传格式,强调MultipartFile需配置解析器,而Part接口无需

multipart格式的数据 会将 一个表单拆分为 多个部分,每个部分对应一个输入域。

在一般的表单输入域中,它所对应的部分中会放置文本型数据,但是如果上传文件的话,它所对应的部分可以是二进制。

配置 multipart 解析器:

有两个:

  • CommonsMultipartResolver:使用 Jakarta Commons FileUpload 解析 multiparty。
  • StandardServletMultipartResolver:依赖于 Servlet 3.0 对 multipart 请求的支持。

配置 StandardServletMultipartResolver 解析器

1、在ApplicationContext 中声明为 bean:

@Bean
public MultipartResolver multipartResolver(){
    return new StandardServletMultipartResolver();
}

2、在 web.xml 或 Servlet 初始化类中,配置 multipart 的具体细节,如:文件大写,临时文件路径等。

  • 如果已经实现了 WebApplicationInitializer 接口,可以在Servlet registration 上调用 setMultipartConfig() 方法进行配置:
@Override
public void onStartup(ServletContext servletContext) throws ServletException {

    DispatcherServlet dispatcherServlet = new DispatcherServlet();
    ServletRegistration.Dynamic registration = servletContext.addServlet("appServlet", dispatcherServlet);
    registration.addMapping("/");
    registration.setMultipartConfig(new MultipartConfigElement("/tmp/uploads"));
}
  • 若 初始化 类 继承了AbstractAnnotationConfigDispatcherServletInitializerAbstractDispatcherServletInitializer 通过重写 customizeRegistration 方法 来配置 multipart 的具体细节
@Override
protected void customizeRegistration(ServletRegistration.Dynamic registration) {
    registration.setMultipartConfig(
            new MultipartConfigElement("/tmp/test/uploads")
    );
}

了解 MultipartConfigElement 类:

new MultipartConfigElement("/tmp/test/uploads",2097152,4194304,0)
  • 指定 临时存放目录 为/tmp/test/uploads
  • 上传文件的最大容量:2097152 = 2MB。
  • 整个 multipart 请求的最大容量 4194304 = 4MB。
  • 文件大写 达到一定容量,会写入 临时文件路径中,默认是 0,所有上传的文件都会写入磁盘中。

对应 在 web.xml 中的配置:

<servlet>
    <servlet-name>appServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <load-on-startup>1</load-on-startup>
    <multipart-config>
    	<!-- 临时路劲 -->
        <location>/tmp/test/uploads</location>
        <!-- 上传文件的最大值 -->
        <max-file-size>2097152</max-file-size>
        <!--请求的最大容量-->
        <max-request-size>4194304</max-request-size>
    </multipart-config>
</servlet>

配置 CommonsMultipartResolver 解析器

声明为 bean

@Bean
public MultipartResolver multipartResolver(){
    return new CommonsMultipartResolver();
}

文件大小,临时路径等在 声明Bean 时设置。

 @Bean
public MultipartResolver multipartResolver() throws IOException {
    CommonsMultipartResolver multipartResolver = new CommonsMultipartResolver();
    // 设置 临时目录
    multipartResolver.setUploadTempDir(new FileSystemResource("/tmp/test/uploads"));
    // 最大文件
    multipartResolver.setMaxUploadSize(2097152);
    
    multipartResolver.setMaxInMemorySize(0);
    return multipartResolver;
}

上传文件、处理文件

表单的大体样式:

<form action="" method="post" enctype="multipart/form-data">
    <input type="file" name="picture" accept="image/jpeg">
    <input type="submit" value="提交">
</form>
  • enctype="multipart/form-data" 告诉 浏览器以 multipart 数据的形式提交表单。
  • accept="image/jpeg" 限制文件接收的类型 为 JPEG。

Controller 上接收上传的文件

@RequestMapping("/upload")
public String uploadImage(@RequestPart("picture")MultipartFile file) throws IOException {
    // 获取 文件 名
    String filename = file.getOriginalFilename();
    // 将 上传的文件 写入到 文件系统中
    file.transferTo(new File("/data/image"+filename));
    return "index";
}
  • MultipartFile 接口,为处理 multipart 数据提供了内容更为丰富的对象。
public interface MultipartFile extends InputStreamSource {
    String getName();

    @Nullable
    String getOriginalFilename();

    @Nullable
    String getContentType();

    boolean isEmpty();

    long getSize();

    byte[] getBytes() throws IOException;

    InputStream getInputStream() throws IOException;

    default Resource getResource() {
        return new MultipartFileResource(this);
    }

    void transferTo(File var1) throws IOException, IllegalStateException;

    default void transferTo(Path dest) throws IOException, IllegalStateException {
        FileCopyUtils.copy(this.getInputStream(), Files.newOutputStream(dest));
    }
}

可以把 MultipartFile 替换为 Servlet.http.Part

@RequestMapping("/upload")
public String uploadImage(@RequestPart("picture") Part file) throws IOException {
    // 获取 文件 名
    String filename = file.getSubmittedFileName();
    // 将 上传的文件 写入到 文件系统中
    file.write("/data/image"+filename);
    return "index";
}

通过 Part 参数接收上传文件,那么没有必要 配置 MultipartResolver 了。只有使用 MultipartFile 的时候,才需要 配置。

总结

以上为个人经验,希望能给大家一个参考,也希望大家多多支持脚本之家。

相关文章

  • java实现简单美女拼图游戏

    java实现简单美女拼图游戏

    这篇文章主要介绍了java实现简单美女拼图游戏的相关资料,需要的朋友可以参考下
    2015-03-03
  • idea中Tomcat启动失败的解决

    idea中Tomcat启动失败的解决

    这篇文章主要介绍了idea中Tomcat启动失败的解决,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-09-09
  • springboot基于IDEA环境热加载与热部署教程

    springboot基于IDEA环境热加载与热部署教程

    这篇文章主要为大家介绍了springboot在IDEA环境下的热加载与热部署教程,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步
    2022-03-03
  • SpringBoot整合BCrypt实现密码加密

    SpringBoot整合BCrypt实现密码加密

    这篇文章主要为大家详细介绍了SpringBoot整合BCrypt进行密码加密,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-11-11
  • Spring Boot 与 Kotlin 上传文件的示例代码

    Spring Boot 与 Kotlin 上传文件的示例代码

    这篇文章主要介绍了Spring Boot 与 Kotlin 上传文件的示例代码,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2018-01-01
  • java Signleton模式详解及示例代码

    java Signleton模式详解及示例代码

    Singleton模式是创建模式。这种模式只涉及一个类是负责创建自己的对象。该类确保只有一个对象获得创建。这个类提供了一种方法来访问它的唯一对象
    2016-10-10
  • Java技术汇总

    Java技术汇总

    本篇文章主要对Java基本知识点和技术点的一些看法和介绍,具有很好的参考价值。下面跟着小编一起来看下吧
    2017-03-03
  • Netty内存池泄漏问题以解决方案

    Netty内存池泄漏问题以解决方案

    这篇文章主要介绍了Netty内存池泄漏问题以解决方案,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2023-12-12
  • Lombok插件有望被Intellij IDEA收编以改善兼容性问题(推荐)

    Lombok插件有望被Intellij IDEA收编以改善兼容性问题(推荐)

    这篇文章主要介绍了Lombok插件有望被Intellij IDEA收编以改善兼容性问题,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2020-08-08
  • Java Javassist轻松操作字节码的技术指南

    Java Javassist轻松操作字节码的技术指南

    Javassist 是一个 Java 库,允许你在运行时定义新类或修改现有类文件,本文主要为大家详细介绍了如何使用Javassist轻松操作字节码,感兴趣的小伙伴可以参考一下
    2025-04-04

最新评论