当前位置： 首页 > news >正文

Spring Boot 中文件上传

news 2026/5/24 23:07:18

Spring Boot 中文件上传

  • 一、MultipartFile
  • 二、单文件上传案例
  • 三、多文件上传案例
  • 四、Servlet 规范
  • 五、Servlet 规范实现文件上传

  • 上传文件大家用的最多的就是 Apache Commons FileUpload，这个库使用非常广泛。Spring Boot3 版本中已经不能使用了。代替它的是 Spring Boot 中自己实现的文件上传。
  • Spring Boot 上传文件现在变得非常简单。提供了封装好的处理上传文件的接口 MultipartReslover，用于解析上传文件的请求，它的内部实现类 StandardServletMultipartResolver。之前常用的 CommonsMultipartResolver 不能使用了。 CommonsMultipartResolver 是使用 Apache Commons File Upload 库时的处理类。

一、MultipartFile

  • StandardServletMultipartResolver 内部封装了读取 POST 请求的请求体中的数据，也就是文件内容。我们只需要在 Controller 的方法中加入形参 @ReqestParam(“参数名”) MultipartFile file。MultipartFile 表示上传的文件，其提供了方便的方法保存文件到磁盘。
    public interface MultipartFile extends InputStreamSource {String getName();//返回参数的名称@NullableString getOriginalFilename();//获取上传文件的名称@NullableString getContentType();//返回文件的内容类型boolean isEmpty();//判断是否为空，或者上传的文件是否有内容long getSize();//返回文件大小 以字节为单位byte[] getBytes() throws IOException;//将文件内容转化成一个byte[] 返回InputStream getInputStream() throws IOException;//返回InputStream读取文件的内容default Resource getResource() {return new MultipartFileResource(this);}//保存上传文件到目标Dest中void transferTo(File dest) throws IOException, IllegalStateException;default void transferTo(Path dest) throws IOException, IllegalStateException {FileCopyUtils.copy(this.getInputStream(), Files.newOutputStream(dest));}
}

二、单文件上传案例

  • 创建两个静态页面，一个用来上传文件（使用表单的方式），另一个用来显示文件上传成功。（注意：静态资源放在 static 目录下，否则访问不到资源）
    • 使用表单的方式上传文件必须满足的三个要求：
      • ① enctype=“multipart/form-data”
      • ② method=“post”
      • ③ <input type=“file” value=“选择文件” name=“uploadFile”>
    <!-- 文件名：uploadfile.html -->
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>上传文件</title>
</head>
<body><h3>上传文件</h3><div></div><form action="uploadFile" enctype="multipart/form-data" method="post">选择需要上传的文件：<input type="file" value="选择文件" name="uploadFile"> <br><input type="submit" value="上传文件"></form>
</body>
</html>

    <!-- 文件名：upload_success.html -->
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>文件上传成功</title>
</head>
<body><h3>文件上传成功</h3>
</body>
</html>
  • 编写controller方法获取请求，然后保存文件。
    @Controller
public class UploadFileController {@PostMapping("/uploadFile")public String uploadFile(@RequestParam("uploadFile") MultipartFile multipartFile) throws IOException {//首先判断上传的文件是否为空if (!multipartFile.isEmpty()) {String suffix = ".unknown";//初始文件后缀为不知道String name = multipartFile.getOriginalFilename();//获取上传的文件名System.out.println(name);//获取文件的后缀if (name != null && name.indexOf(".") > 0) {suffix = name.substring(name.indexOf("."));}String dest = UUID.randomUUID() + suffix;//生成保存的文件名multipartFile.transferTo(new File("G:/files/" + dest));//保存文件到指定位置}//防止刷新，重复上传return "redirect:/upload_success.html";}
}
  • 编写错误页面
    • 在 SpringBoot 中 /static/error/5xx.html 文件 ===> 如果出现 5xx 的错误自动跳转到整个页面。
    • 在 SpringBoot 中 /static/error/4xx.html 文件 ===> 如果出现 4xx 的错误自动跳转到整个页面 。
    <!-- 文件名：5xx.html -->
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
<h3>出现了 5XX 错误！！！</h3>
</body>
</html>

    <!-- 文件名：4xx.html -->
<!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>Title</title>
</head>
<body>
<h3>出现了 4XX 错误！！！</h3>
</body>
</html>
  • 设置上传文件的大小
    • Spring Boot 默认单个文件最大支持1M，一次请求最大10M。改变默认值，需要修改 application.yml 配置文件。file-size-threshold 超过指定大小，直接写文件到磁盘，不在内存处理。
      在这里插入图片描述
  • 不能只考虑SpingBoot每次请求的文件最大大小，还需要设置服务器每次请求的大小。

三、多文件上传案例

  • 多文件上传，在接收文件参数部分有所改变 MultipartFile[] files。循环遍历数组解析每一个上传的文件。
  • 前端通过 form 表单上传多文件。
    <!DOCTYPE html>
<html lang="en">
<head><meta charset="UTF-8"><title>上传文件</title>
</head>
<body><h3>上传文件</h3><div></div><form action="uploadFile" enctype="multipart/form-data" method="post">选择需要上传的文件 1：<input type="file" value="选择文件" name="uploadFile"> <br>选择需要上传的文件 2：<input type="file" value="选择文件" name="uploadFile"> <br>选择需要上传的文件 3：<input type="file" value="选择文件" name="uploadFile"> <br><input type="submit" value="上传文件"></form>
</body>
</html>

四、Servlet 规范

  • Servlet3.0 规范中，定义了 Jakarta.servlet.http.Part 接口处理 mulitipart/form-data POST 请求中接收到的表单数据。有了 Part 对象，其 write() 方法将上传文件保存到服务器本地的磁盘中。

  • 在 HttpServletRequest 接口中引入的新方法：

    • getParts()：返回 Part 对象的集合。
    • getPart(字符串名称)：检索具有给定名称的单个 Part 对象。

  • Spring Boot3 使用的 Servlet 规范是基于 5 的，所以上传文件使用的就是 Part 接口。

  • StandardServletMultipartResolver 对 Part 接口进行的封装，实现基于 Servlet 规范的文件上传。

    public interface Part {InputStream getInputStream() throws IOException;//获取输入流用于检索文件的内容String getContentType();//获取文件内容类型String getName();//获取file控件的name属性String getSubmittedFileName();//获取上传文件名Servlet3.1 Tomcat8.0实现long getSize();//获取上传文件的大小void write(String fileName) throws IOException; //将文件内容写入指定的磁盘位置void delete() throws IOException;//删除Part数据和临时目录数据,默认会删除String getHeader(String name);//获取指定请求头Collection<String> getHeaders(String name);//获取指定header名称的集合数据Collection<String> getHeaderNames();//获取所有请求头的名称
}

五、Servlet 规范实现文件上传

    @PostMapping("/files")public String upload(HttpServletRequest request){try {for (Part part : request.getParts()) {String fileName = extractFileName(part);part.write(fileName);}} catch (IOException | ServletException e) {throw new RuntimeException(e);}return "redirect:/upload_success.html";}private String extractFileName(Part part) {String contentDis = part.getHeader("content-disposition");String[] items = contentDis.split(";");for (String s : items) {if (s.trim().startsWith("filename")) {return s.substring(s.indexOf("=") + 2, s.length()-1);}}return "";}
  • 上传文件包含 header 头 content-disposition，类似如下的内容，可获取文件原始名称。
    • form-data; name=“dataFile”;filename=“header.png”
  • application.yal 文件，可配置服务器存储文件位置，例如：
    • spring.servlet.multipart.location=G:/files/

相关文章：

Spring Boot 中文件上传

Spring Boot 中文件上传 一、MultipartFile二、单文件上传案例三、多文件上传案例四、Servlet 规范五、Servlet 规范实现文件上传 上传文件大家用的最多的就是 Apache Commons FileUpload&#xff0c;这个库使用非常广泛。Spring Boot3 版本中已经不能使用了。代替它的是 Sprin…...

编程日记 2024/1/31 18:49:43

2023年06月CCF-GESP编程能力等级认证Python编程一级真题解析

一、单选题（共15题，共30分） 第1题 以下不属于计算机输出设备的有（）。 A：麦克风 B：音箱 C：打印机 D：显示器 答案：A 第2题 ChatGPT 是 OpenAI 研发的聊天机器人程序，它能通过理解和学习人类的语言来进行对话，还能根据聊天的上下文进行互动，完成很多工作。请你…...

编程日记 2024/1/31 18:47:41

unity 使用数字图片来代替数字0到9显示

using System.Collections; using System.Collections.Generic; using UnityEngine; using UnityEngine.UI; public class Trackracecomplete : MonoBehaviour { /// /// 数字图片 /// [SerializeField] private Sprite[] sprites; private string _Time “23:57:49”; [Ser…...

编程日记 2024/1/31 18:45:38

单片机如何实现延时1ms或者1us

1us //适配主频为120MHz的单片机 void Delay_us(int16_t nus) {int32_t temp; SysTick->LOAD nus*15; //120MHzSysTick->VAL0X00;SysTick->CTRL0X01;do { tempSysTick->CTRL;}while((temp&0x01)&&(!(temp&(1<<16))));SysTick->CTRL0x0…...

编程日记 2024/1/31 18:41:32

全国网络安全行业职业技能大赛WP

word_sercet 文档被加密 查看图片的属性 在备注可以看到解压密码 解密成功 在选项里面把隐藏的文本显示出来 可以看到ffag easy_encode 得到一个bmp二维码 使用qr research 得到的密文直接放瑞士军刀 base32解码base64解码hex解码 dir_pcap 直接搜索flag 发现flag…...

编程日记 2024/1/31 18:40:32

【Python函数与模块】（7）模块的分类与好处

文章目录 一、模块分类二、模块的好处 一、模块分类 Python标准模块&#xff08;内置模块&#xff0c;标准库&#xff09; 第三方模块/库&#xff08;pypi.org&#xff09; 自定义模块 二、模块的好处 可维护性更强 方便代码重用...

编程日记 2024/1/31 18:38:29

如何安全地多开Facebook/Twitter/TK/Ins等账号？

随着社交媒体的普及&#xff0c;人们需要在不同平台上管理多个账号。然而&#xff0c;如何安全地多开这些账号却是一个需要关注的问题。本文将介绍如何安全地多开Facebook、twitter、YouTube、TikTok等平台账号的方法。 重要关联因素&#xff1a; 1. 隐私和安全&#xff1a;保…...

编程日记 2024/1/31 18:36:27

ChatGPT学python: 用json文件传参

目录 json语法最简陋版python解析语法小结 json语法最简陋版 param.json [{"Table_name": "table1","Event_name_colum": 4,"update_colum": 9},{"Table_name": "table2","Event_name_colum": 3,&quo…...

编程日记 2024/1/31 18:33:24

【C++航海王：追寻罗杰的编程之路】引用、内联、auto关键字、基于范围的for、指针空值nullptr

目录 1 -> 引用 1.1 -> 引用概念 1.2 -> 引用特性 1.3 -> 常引用 1.4 -> 使用场景 1.5 -> 传值、传引用效率比较 1.6 -> 值和引用作为返回值类型的性能比较 1.7 -> 引用和指针的区别 2 -> 内联函数 2.1 -> 概念 2.2 -> 特性 3 -…...

编程日记 2024/1/31 18:32:23

已实现：vue、h5项目如何使用echarts实现雷达图、六边形图表

说实话&#xff0c;要说图表里&#xff0c;最强的应该属于echarts了&#xff0c;不管是接入难度上&#xff0c;还是样式多样性上&#xff0c;还有社区庞大程度上&#xff0c;都是首屈一指的&#xff0c;反观有的人习惯用chart.js了&#xff0c;这个无可厚非&#xff0c;但是如果…...

编程日记 2024/1/31 18:29:20

JUC并发编程-四大函数式接口、Stream 流式计算、ForkJoin并行执行任务

12. 四大函数式接口 新时代的程序员&#xff1a;lambda表达式、链式编程、函数式接口、Stream流式计算 函数式接口&#xff1a;只有一个方法的接口&#xff0c;可以有一些默认的方法 如&#xff1a;Runnable接口函数 1&#xff09;Function 函数型接口 public class Functio…...

编程日记 2024/1/31 18:28:18

【Tomcat与网络4】Tomcat的连接器设计

目录 1 如何设计一个灵活可靠的连接器 2 主要组件介绍 在上一篇&#xff0c;我们介绍了Tomcat提供服务的整体结构&#xff0c;本文我们一起来看一下Tomcat的连接器的设计。 在前面我们提到Tomcat主要完成两个功能&#xff1a; 处理 Socket 连接&#xff0c;负责网络字节流与…...

编程日记 2024/1/31 18:26:17

k8s中调整Pod数量限制的方法

一、介绍 Kubernetes节点每个默认允许最多创建110个pod&#xff0c;有时可能由于主机配置扩容的问题&#xff0c;从而需要修改节点pod运行数量的限制。 即&#xff1a;需要调整Node节点的最大可运行Pod数量。 一般来说&#xff0c;只需要在kubelet启动命令中增加–max-pods参数…...

编程日记 2024/1/31 18:25:16

在Java中，实现扩展性通常有几种方法，其中包括接口、抽象类、插件架构和服务加载等方式

在Java中&#xff0c;实现扩展性通常有几种方法&#xff0c;其中包括接口、抽象类、插件架构和服务加载等方式。以下是如何使用接口来实现灵活的扩展和插件管理的一些基本指导&#xff1a; 定义基础接口&#xff1a; 创建一个或多个基础接口&#xff0c;这些接口定义了所有实现…...

编程日记 2024/1/31 18:24:15

【乳腺肿瘤诊断分类及预测】基于自适应SPREAD-PNN概率神经网络

课题名称&#xff1a;基于自适应SPREAD-PNN的乳腺肿瘤诊断分类及预测 版本日期&#xff1a;2023-06-15 运行方式: 直接运行PNN0501.m 文件即可 代码获取方式&#xff1a;私信博主或QQ&#xff1a;491052175 模型描述&#xff1a; 威斯康辛大学医学院经过多年的收集和整理&…...

编程日记 2024/1/31 18:23:14

蓝桥杯AT24C02问题记录

问题1&#xff1a;从这个图片上可以看出这两个在IIC的.c文件里延时时间不一样&#xff0c;第一张图使用了15个_nop_(); 12M晶振机器周期是 1/12M*121uS&#xff1b;nop()要延时1个指令周期。延时时间不对会对时序产生影响&#xff0c;时序不对&#xff0c;则AT24C02有没被使用…...

编程日记 2024/1/31 18:22:13

adb控制设备状态

屏幕设置 屏幕亮度 # 当前屏幕亮度 adb shell settings get system screen_brightness# 更改屏幕亮度adb shell settings put system screen_brightness屏幕休眠时间 # 当前屏幕休眠时间 adb shell settings get system screen_off_timeout#更改屏幕休眠时间 adb shell sett…...

编程日记 2024/1/31 18:20:11

订婚支出及共同生活消费是否属于彩礼？应否返还？

恋爱期间&#xff0c;男女双方为增进情感而互赠财物的现象十分普遍。而当双方关系结束时&#xff0c;赠送财物的一方要求对方返还时&#xff0c;法院能否支持其主张&#xff1f; 一起男方向女方及女方母亲索要彩礼及恋爱期间花销钱款引发的婚约财产纠纷案&#xff0c;法院综合双…...

编程日记 2024/1/31 18:19:10

MicroPython核心：优化

MicroPython使用多种优化方法来节省RAM&#xff0c;同时确保程序的高效执行&#xff0c;本文会讨论其中的一些优化。 提示&#xff1a; MicroPython 字符串驻留&#xff08;string interning&#xff09; 和映射和字典(Maps and Dictionaries) 详细介绍了对字符串和字典的其他…...

编程日记 2024/1/31 18:18:09

Opencv——霍夫变换

霍夫直线变换 霍夫直线变换(Hough Line Transform)用来做直线检测 为了加升大家对霍夫直线的理解,我在左图左上角大了一个点,然后在右图中绘制出来经过这点可能的所有直线 绘制经过某点的所有直线的示例代码如下,这个代码可以直接拷贝运行 import cv2 as cv import matplot…...

编程日记 2024/1/31 18:16:07

英语 听力 重读软件app

写一个可以读取一个pdf,或者doc 的apk。并语音播放出来。可以用语音指令或者某些在界面上的按键来控制&#xff0c;重复上一句&#xff0c;或者重复上一段&#xff0c;或者重复上5句&#xff0c;重复上10句&#xff0c;重复上3句。重复整个段落&#xff0c;重复整个章节。还有一…...

编程新知 2026/5/24 22:20:34

如何免费解锁Wand专业版功能：Wand-Enhancer完整使用指南

如何免费解锁Wand专业版功能&#xff1a;Wand-Enhancer完整使用指南 【免费下载链接】Wand-Enhancer Advanced UX and interoperability extension for Wand (WeMod) app 项目地址: https://gitcode.com/gh_mirrors/we/Wand-Enhancer 还在为Wand&#xff08;原WeMod&…...

编程新知 2026/5/24 22:18:34

告别笔记本续航焦虑：手把手教你用NVMe电源管理给SSD“降频省电”

告别笔记本续航焦虑&#xff1a;手把手教你用NVMe电源管理给SSD“降频省电”每次带着笔记本出差&#xff0c;最担心的就是电量撑不过一场会议。你可能已经关闭了背光键盘、调低了屏幕亮度&#xff0c;甚至忍痛停用了独显&#xff0c;但续航依然捉襟见肘。其实&#xff0c;有一个…...

编程新知 2026/5/24 21:57:36

利用 Taotoken 为不同业务场景动态选择最合适的大模型

&#x1f680; 告别海外账号与网络限制&#xff01;稳定直连全球优质大模型&#xff0c;限时半价接入中。 &#x1f449; 点击领取海量免费额度 利用 Taotoken 为不同业务场景动态选择最合适的大模型 在构建一个集成了大模型能力的应用时&#xff0c;一个常见的挑战是如何为不…...

编程新知 2026/5/24 21:40:46

如何用一款免费工具，让20+平台直播内容成为你的数字资产？

如何用一款免费工具&#xff0c;让20平台直播内容成为你的数字资产&#xff1f; 【免费下载链接】fideo-live-record A convenient live broadcast recording software! Supports Tiktok, Youtube, Twitch, Bilibili, Bigo!(一款方便的直播录制软件! 支持tiktok, youtube, twit…...

编程新知 2026/5/24 19:19:03

智能体系统设计简明教程

曾经有一段时间&#xff0c;软件系统大多在等待。 它们等待请求&#xff0c;等待输入&#xff0c;等待工程师已经知道系统应该执行的操作序列而编写的明确指令。 即使是大规模分布式系统&#xff0c;在很大程度上也是在同一个假设下运行的。复杂性来自于规模、并发和协调——…...

编程新知 2026/5/24 19:08:43

鸣潮自动化脚本终极指南：解放双手的完整解决方案

鸣潮自动化脚本终极指南&#xff1a;解放双手的完整解决方案 【免费下载链接】ok-wuthering-waves 鸣潮 后台自动战斗 自动刷声骸 一键日常 Automation for Wuthering Waves 项目地址: https://gitcode.com/GitHub_Trending/ok/ok-wuthering-waves 你是否厌倦了在《鸣潮…...

编程新知 2026/5/24 17:26:58

QQ音乐格式解密终极指南：qmcdump带你打破数字音乐枷锁

QQ音乐格式解密终极指南&#xff1a;qmcdump带你打破数字音乐枷锁 【免费下载链接】qmcdump 一个简单的QQ音乐解码&#xff08;qmcflac/qmc0/qmc3 转 flac/mp3&#xff09;&#xff0c;仅为个人学习参考用。 项目地址: https://gitcode.com/gh_mirrors/qm/qmcdump 音乐&…...

编程新知 2026/5/24 17:12:28

从云服务器到树莓派：不同场景下Linux IP地址类型的管理与查看技巧（ip/nmcli实战）

从云服务器到树莓派&#xff1a;Linux IP地址管理的场景化实战指南在混合计算环境中工作的开发者常常面临一个看似简单却充满陷阱的问题&#xff1a;如何快速确定当前Linux设备的IP地址类型&#xff1f;这个问题在公有云、本地虚拟机和嵌入式设备等不同场景下有着截然不同的答案…...

编程新知 2026/5/24 16:57:34

分布式接口幂等性设计：唯一索引、Token 与分布式锁

接口幂等性解决的是“同一个请求被执行多次&#xff0c;会不会造成重复业务效果”的问题。用户重复点击、网络重试、MQ 重复消费&#xff0c;都可能让同一业务被重复执行。 一句话概括&#xff1a;幂等就是多次调用和一次调用的业务结果一致&#xff1b;查询和按唯一值删除天然…...

编程新知 2026/5/24 16:00:55