SpringBoot实现接受文件和对象

 更新时间:2025年12月06日 09:36:30   作者:LitongZero  
SpringBoot中接受文件和对象的场景,推荐使用`multipart/form-data`格式,后端可以通过接受实体并将文件放入对象属性中来处理数据,使用`@Validated`注解进行参数校验是可行的,但要注意不要与`@RequestBody`注解同时使用

SpringBoot接受文件和对象

使用场景

某个接口,需要同时接受文件和实体,也就是参数。

  • 这个时候,前端就不能json格式传送数据了,要用到multipart/form-data;这种格式传送数据。
  • 那么,这个时候,后端应该怎样接受这个参数和文件呢?

1.接受HttpServletRequest,自己处理request(不推荐)

@PostMapping(value = "/upload")    
@ResponseBody    
public String handleFileUpload(HttpServletRequest request) {    
MultipartHttpServletRequest params=((MultipartHttpServletRequest) request);  
// 获取文件
List<MultipartFile> files = ((MultipartHttpServletRequest) request).getFiles("file");   
// 获取参数
String name=params.getParameter("name");  

2.接受实体,将文件放到对象属性中(推荐)

public class UserFileReq {
	// 参数
    private String username;
    // 文件
    private MultipartFile file;
    // 省略get\set
}

@PostMapping(value = "/upload")    
@ResponseBody    
public String handleFileUpload(UserFileReq req) {    
// 文件和参数 都在实体中了
}

3.接受参数,将文件放到接受参数中

这种方法适合接受单个文件参数,多参数还是建议用对象接受,方便扩展

@PostMapping(value = "/upload")    
@ResponseBody    
public String handleFileUpload(MultipartFile file) {    
}

4.一个坑

使用第二种方法的时候,一定不要加@RequestBody,加了这个注解,就会报如下错误。

{
 "timestamp": 1571196217195,
 "status": 415,
 "error": "Unsupported Media Type",
 "exception": "org.springframework.web.HttpMediaTypeNotSupportedException",
 "message": "Content type 'multipart/form-data;boundary=2gOOYeFBpE;charset=UTF-8' not supported",
 "path": "/file/upload"
}

所以,接受文件,不要使用@RequestBody注解

但是@Validated注解(校验参数的注解)是可以使用的。

总结

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

相关文章

  • java 同步器SynchronousQueue详解及实例

    java 同步器SynchronousQueue详解及实例

    这篇文章主要介绍了java 同步器SynchronousQueue详解及实例的相关资料,需要的朋友可以参考下
    2017-05-05
  • springMVC返回复杂的json格式数据方法

    springMVC返回复杂的json格式数据方法

    下面小编就为大家分享一篇springMVC返回复杂的json格式数据方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-03-03
  • Java实现将二叉树展开为链表的两种方法

    Java实现将二叉树展开为链表的两种方法

    文章介绍了两种方法将二叉树按前序遍历顺序展开为单链表,方法一为迭代法,方法二为前序遍历+列表重建,两者各有优缺点,选择时需根据实际需求和场景考虑,下面小编给大家详细说说
    2025-05-05
  • 关于Springboot中JSCH的使用及说明

    关于Springboot中JSCH的使用及说明

    这篇文章主要介绍了关于Springboot中JSCH的使用及说明,具有很好的参考价值,希望对大家有所帮助。
    2022-09-09
  • 带你深入了解java-代理机制

    带你深入了解java-代理机制

    Java 有两种代理方式,一种是静态代理,另一种是动态代理。如果我们在代码编译时就确定了被代理的类是哪一个,那么就可以直接使用静态代理;如果不能确定,那么可以使用类的动态加载机制,在代码运行期间加载被代理的类这就是动态代理
    2021-08-08
  • springboot如何集成Swagger2

    springboot如何集成Swagger2

    这篇文章主要介绍了springboot集成Swagger2的方法,帮助大家更好的理解和使用springboot框架,感兴趣的朋友可以了解下
    2020-12-12
  • SpringBoot 整合数据源的具体实践

    SpringBoot 整合数据源的具体实践

    本文主要介绍了SpringBoot 整合数据源的具体实践,利用 Spring Boot 的自动配置和简化的注解来简化数据源配置工作,从而更专注于应用程序的业务逻辑开发,感兴趣的可以了解一下
    2023-11-11
  • 关于SpringMVC请求域对象的数据共享问题

    关于SpringMVC请求域对象的数据共享问题

    这篇文章主要介绍了SpringMVC请求域对象的数据共享问题,本文通过实例代码给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2022-02-02
  • SpringBoot修改yml配置和加载顺序规则的示例详解

    SpringBoot修改yml配置和加载顺序规则的示例详解

    这篇文章主要为大家详细介绍了SpringBoot如何修改yml配置和加载顺序规则,文中的示例代码讲解详细,感兴趣的小伙伴可以跟随小编一起学习一下
    2025-08-08
  • 基于Java实现Word中插入附件的操作指南(支持所有文件格式)

    基于Java实现Word中插入附件的操作指南(支持所有文件格式)

    文章介绍了如何使用Java在Word文档中嵌入附件,并通过OLE方式实现,主要步骤包括:引入依赖、组装附件图标、默认附件图标、组装Ole对象、插入附件到Word文档以及使用模板,文章末尾提供了实现代码和下载OLE模板的链接,需要的朋友可以参考下
    2025-12-12

最新评论