springboot之如何快速实现多文件上传？若不会，我便手把手教你详细

Posted 2022-06-30 bug菌¹

👨‍🎓作者：bug菌

✏️博客：CSDN、掘金等

💌公众号：猿圈奇妙屋

🚫特别声明：原创不易，转载请附上原文出处链接和本文声明，谢谢配合。

🙏版权声明：文章里可能部分文字或者图片来源于互联网或者百度百科，如有侵权请联系bug菌处理。

一、前言🔥

环境：jdk1.8 + springboot 2.3.1RELEASE

二、需求分析🔥

        突然加了这么个需求，要求对用户材料文件需要手动上传并指定文件路径保存。好家伙，一听，觉得没啥问题，又觉得有点欠妥，于是我便问了这么一句，需要支持文件批量嘛？你不问我还没觉得，那就加上吧！可支持用户批量上传。

        这不是自己给自己加戏么?这开过光的嘴！说啥来啥，那能咋办，干就完了！

三、实现思路🔥

        其实对于文件上传，还是老样子，通过formData表单提交的方式进行文件附件上传，而不是现在所谓的json接收格式数据，比如@RequestBody注解；那为什么不能用它来接收？因为@RequestBody默认接收的enctype(MIME编码)是application/json，因此发送POST请求时需要设置请求报文头信息，否则SpringMVC在解析集合请求参数时是不会自动转换成JSON数据再解析成相应的集合。

        那对于multipart/form-data 提交方式，那我们就可以通过使用@RequestParam(springmvc中接收普通参数的注解)，将请求参数绑定到控制器的方法参数上，或者你也省略映射不需要绑定(这就要求命名必须一致)，那就靠spring对于formdata带文件和数据字段一起上传的情况做自动映射。如果需要对参数进行重命名， 那么你就可以使用@RequestParam 映射前端传过来的字段名，而接收的时候自己自定义就行，比如如下这种方式，前端传给你的参数字段叫id，而你接收则是用dfId。

@RequestParam("id") String dfId

        而对于多文件的话，我们就可以定义一个 MultipartFile 数组接收即可。比如如下演示：

@RequestParam("files") MultipartFile[] files

        这样的话，结合一下不就支持多文件上传协同其他字段一并提交处理了。

四、实现方案🔥

        通过上方我们对此的分析可得，我们可以有两种方式可以进行实现，虽然大同小异，但是论标准，我就给大家讲一种最合理的实现方式，接下来我以实际例子作为演示。

        比如，批量文件+数据字段的情况，论这种需求接口应该怎么定义呢？很好办呀？看我给大家露一手。仅供参考：

具体实现代码如下：

    @PostMapping(value = "/upload-files")
    @ApiOperation(value = "文件上传(支持批量)", notes = "文件上传(支持批量)")
    public ResultResponse<Boolean> uploadFiles(@RequestParam("files") MultipartFile[] files,
                                               @RequestParam("type")  Integer type,
                                               @RequestParam("id") String dfId) throws IOException 
        return declarationFormService.uploadFiles(files, type, dfId);
    

        然后我们来通过postman来测试下该接口，看看是否能拿到该参数信息，包括文件。

         接下来我们在接口上打个断点，查看一下这些参数能否都被正常接收？

如下是实际断点截图：

         接收到的参数信息与我postman所添加的参数内容完全一致，接收正常，能看到文件也是以数组的格式展示(MultipartFile [ 2 ])，这就意味着你待会儿如果要进行文件保存，那你就可以通过使用files进行循环一波即可。

比如我实际保存写法，仅供参考：

... ....

         好啦，以上就是实现多文件+数据字段一并上传的实现方案啦。如果对你有所帮助，还请不要忘记给bug菌[ 三连支持 ]哟。如果想获得更多的学习资源或者想和更多的技术爱好者一起交流，可以关注我的公众号『猿圈奇妙屋』，后台回复关键词领取学习资料、大厂面经、面试模板等海量资源，就等你来拿。

---

五、文末🔥

        如果你还想要学习更多，小伙伴们大可关注bug菌专门为你们创建的专栏《springboot零基础入门教学》，都是我一手打下的江山，持续更新中，希望能帮助到更多小伙伴们。

       我是bug菌，一名想走👣出大山改变命运的程序猿。接下来的路还很长，都等待着我们去突破、去挑战。来吧，小伙伴们，我们一起加油！未来皆可期，fighting！

        最后送大家两句我很喜欢的话，与诸君共勉！

---

☘️做你想做的人，没有时间限制，只要愿意，什么时候都可以start。

🍀你能从现在开始改变，也可以一成不变，这件事，没有规矩可言，你可以活出最精彩的自己。

---

​​​​

💌如果文章对您有所帮助，就请留下您的赞吧！(#^.^#)；

💝如果喜欢bug菌分享的文章，就请给bug菌点个关注吧！(๑′ᴗ‵๑)づ╭❤～；

💗如果对文章有任何疑问，还请文末留言或者加群吧【QQ交流群:708072830】；

💞鉴于个人经验有限，所有观点及技术研点，如有异议，请直接回复参与讨论(请勿发表攻击言论，谢谢）；

💕版权声明：原创不易，转载请附上原文出处链接和本文声明，版权所有，盗版必究！！！谢谢。