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

JavaWeb文件上传

news 2026/3/26 4:02:16

文件上传总览

文件上传主要是指将本地文件（包括但不限于图片、视频、音频等）上传到服务器，提供其他用户浏览或下载的过程。在日常生活中，我们在很多情况下都需要使用文件上传功能，比如：发微博、发朋友圈等（这里主要是指照片和视频文件），可见文件上传的重要性。文件上传功能实现需要涉及到两个部分，一个部分是前端程序、一个部分是后端程序，本文将前后端分开讲解。

接收文件

文件上传的前端准备

前端若想进行文件上传（网页的文件上传），就必须要有文件上传的三要素，前端必须要有这三要素才可以完成文件上传。前端要想实现文件上传就必须定义一个form表单，其中必须要有一个表单项类型为file；表单的提交方式必须是post方式，其原因是get方式提交有大小限制（并且不是很大），但文件上传可能涉及到大文件，所以说应该使用post方式提交表单；其最后一个要素，也是最重要的要素，就是在form表单中需要通过enctype属性设置表单的编码格式为 "multipart/form-data"，这个设置非常重要——文件的本质上是二进制数据，而form表单的默认编码格式（x-www-form-urlencoded）是不适合传递二进制数据的。

假如说使用form表单默认的编码格式传输文件的问题：简单概括就是使用x-www-form-urlencoded编码格式传输文件，不会传输文件中的内容（数据），只能传输一个文件名。假如说我有一个.txt文本文件，使用默认的编码格式进行上传：

（该文件是有内容的）

该表单的编码格式是默认的x-www-form-urlencoded

 

发现上传的文件数据只有上传的文件的文件名，这证明了若使用form表单的默认编码格式，那么传输文件是失败的，只会上传文件的文件名。 总结一下文件上传的前端准备： 需要一个form表单，表单中需要一个表单项类型为file，并且该表单的提交方式必须为post，而且表单的编码格式必须修改为multipart/form-data。

文件上传的后端程序

文件上传的后端程序首先肯定是需要一个控制方法（SpringBoot），用于接收文件上传这个“功能接口”的请求，并且请求的其他数据之前怎么接收现在仍然怎么接收（比如简单参数、实体参数、日期参数等，还是像之前那么接收即可）；请求提交的文件需要用SpringBoot提供的对象MultipartFile接收（前端中file表单项的名称必须和控制方法参数列表中MultipartyFile对象名完全相同）

创建请求处理类，并定义文件上传功能接口的控制器方法

@Slf4j
@RestController
public class FileController {@PostMapping("/upload")public Result upload(String username, Integer age, MultipartFile image) {log.info("文件上传：{}，{}，{}", username, age, image);return Result.success();}
}

此时通过前端页面发起请求：

<!DOCTYPE html>
<html lang="ch-ZN">
<head><meta charset="UTF-8"><title>上传文件</title>
</head>
<body><form action="/upload" method="post" enctype="multipart/form-data">姓名: <input type="text" name="username"><br>年龄: <input type="text" name="age"><br>头像: <input type="file" name="image"><br><input type="submit" value="提交"></form></body>
</html>

 通过调试启动服务，发现此时可以成功接收到上传的文件，并获取文件的路径：

转到该路径下发现了三个.temp的临时文件： 

这是因为该表单有三个表单项，分别是两个text表单项（username和age）和一个file表单项（image文件），两个大小小的就是传的username和age的值，30kb那个temp文件就是上传的文件了，通过记事本打开验证一下：

 

 

现在已经在服务端接收到了文件，但是一但程序运行停止，这些临时文件也会消失——只要这次请求响应结束结束后（不管成功与否），临时文件都会被删除，所以说后端程序不但要接收上传的文件，更重要的是还需要将接收到的文件保存起来。总结一下文件上传的准备工作： 前端页面需要三要素：1.需要在form表单中定义一个表单项的type为file；2.需要指定表单的提交方式为post；3.需要指定表单的编码格式enctype为multipart/form-data。 这三要素缺一不可！后端需要使用Spring框架提供的MultipartFile类来接收前端上传的文件。

本地存储

上述代码成功在服务端接收到了客户端上传的文件，但是发现只能生成一个临时文件，一但这次请求响应结束后，.temp临时文件就会自动删除，这显然是不符合开发逻辑的，所以说我们需要将这些.temp临时文件存储起来。此处先介绍本地存储。

本地存储就是：在服务端接收到客户端上传的文件之后，将文件存储在本地服务器磁盘中。因为是基于SpringBoot框架，这其实并不困难，因为Spring框架中的MultipartFile对象提供了这样的方法——transferTo，transferTo的参数中需要传递一个File文件对象，就是将.temp临时文件写入到这个传递的文件对象中完成文件的本地存储。

此处在获取File对象的时候出现一个问题：不能把文件名写死了——因为假如有多个文件时，若把文件名写死了，那么后接收到的文件就会把前一次接收到的文件的内容覆盖了，整个功能接口就只能保存一个文件了。此时的解决方法是将File对象的文件名存储为上传文件的原文件名，MultpartFile对象中封装了上传文件的所有信息，并且提供了对应的方法获取这些信息，所以说直接可以通过操作MultipartFile对象得到原文件名：

@Slf4j
@RestController
public class FileController {@PostMapping("/upload")public Result upload(String username, Integer age, MultipartFile image) throws IOException {String originalFilename = image.getOriginalFilename();image.transferTo(new File("E:\imagesTest\" + originalFilename));return Result.success();}
}

此时代码就可以正确的接收到客户端上传的文件并将其保存在File指定的路径了：

 

但此时还有一个问题，假如说A用户上传了一个1.txt文件，接着B用户又上传了一个txt文件，也叫1.txt，那么就会出现B用户的文件内容将A用户的文件内容覆盖的问题，因为本地存储是按照文件的原名称存储的，遇到重名文件就会出现这样的问题。

避免文件名重复导致的覆盖问题

可能有人会想到使用System.currentTimeMillis()这个方法获取当前时间的毫秒值作为文件名避免重复，但是在一些大的项目中，有可能同一毫秒就正好有两个人上传了同一个同名的文件，这还是不能从根本上解决文件名重复的问题；解决这个问题可以使用UUID（通用唯一识别码）作为文件名进行存储，UUID是不会重复的（小概率事件不发生）。

但是又存在一个问题，假如说将UUID作为文件名，那么文件的扩展名是什么？ 其实也非常简单，因为我们已经得到了文件的原名称，通过寻找到原文件名（字符串）中最后一个“.”所处的位置（因为无论文件名是什么，最后一个.之后的才是扩展名），找到最后一个“.”所处的位置之后，直接通过subString()方法截取到最后就可以获取文件的扩展名了，然后再将其和UUID进行拼接，就可以生成一个以UUID命名存储的文件了。

@PostMapping("/upload")
public Result upload(String username, Integer age, MultipartFile image) throws IOException {// 获取原文件名String originalFilename = image.getOriginalFilename();// 获取最后一个“.”的索引int index = originalFilename.lastIndexOf(".");// 通过subString方法和最后一个“.”索引进行截取，获取文件扩展名String externalName = originalFilename.substring(index);// UUID + 扩展名 = 新文件名String newFileName = UUID.randomUUID().toString() + externalName;image.transferTo(new File("E:\imagesTest\" + newFileName));return Result.success();
}

此时，文件在本地存储就是UUID了，再也不会有重复的可能了。

文件上传的大小配置

在SpringBoot框架中，文件上传，默认单个文件允许最大大小为1M。如果需要上传大文件，可以根据需求在application.properties（我使用的是yaml配置文件进行配置，思想是一样的，只是配置的格式不同）配置文件中进行设置：

servlet:multipart:# 配置单个文件最大上传大小（默认1MB）max-file-size: 10MB# 配置单个请求最大上传大小（一次请求可以上传多个文件）max-request-size: 100MB

这样配置之后，就可以根据需求上传大文件了。

本地存储不足

1.将文件存储到本地，无法通过浏览器等直接访问到文件。

2.若项目中上传了大量文件，这些文件都存储到服务器的本地磁盘，服务器的磁盘空间是十分宝贵的，用来存储用户上传的文件是十分浪费的，并且若服务器的磁盘存储空间满了，想要扩容也是十分困难的，并且现在很多项目都是服务器集群，扩容就更加困难了。

3.若服务器的磁盘损坏，存储的文件恢复极其困难，安全性不高。

现在几乎已经不使用本地存储了，都是使用云存储。

 

 

 

相关文章：

JavaWeb文件上传

文件上传总览 文件上传主要是指将本地文件&#xff08;包括但不限于图片、视频、音频等&#xff09;上传到服务器&#xff0c;提供其他用户浏览或下载的过程。在日常生活中&#xff0c;我们在很多情况下都需要使用文件上传功能&#xff0c;比如&#xff1a;发微博、发朋友圈等…...

编程日记 2024/12/11 3:44:56

软件工程——期末复习（3）

一、题目类(老师重点提到过的题目) 1、高可靠性是否意味着高可用性&#xff1f;试举例证明自己的观点&#xff1f; 答&#xff1a;高可靠性不意味着高可用性 可靠性说明系统已经准备好&#xff0c;马上可以使用&#xff1b;可用性是系统可以无故障的持续运行&#xff0c;是一…...

编程日记 2024/12/11 3:40:51

apache的BeanUtils的Converter被相互污染覆盖问题

问题描述 apache的BeanUtils工具集中用来把map对象转换为java对象的BeanUtils#populate方法会因为单例的原因其转换器Converter被相互污染覆盖问题 maven依赖 <dependency><groupId>commons-beanutils</groupId><artifactId>commons-beanutils</…...

编程日记 2024/12/11 3:39:49

TCP的“可靠性”（上）

目录 TCP的“可靠性”&#xff08;上&#xff09;确认应答&#xff08;可靠性传输的基础&#xff09;超时重传连接管理&#xff08;三次握手&#xff0c;四次挥手&#xff09; TCP的“可靠性”&#xff08;上&#xff09; 想必大家都或多或少的听说过TCP的特性&#xff1a;有连…...

编程日记 2024/12/11 3:35:45

超标量处理器设计笔记（5）虚拟存储器、地址转换、page fault

虚拟存储器 概述地址转换单级页表多级页表案例最好情况&#xff1a;虚拟地址是连续的最差情况&#xff1a;每个第二级 PT 都装有一项 增加级数 Page Fault 程序保护 概述 当程序比物理内存空间更大时&#xff0c;无法全部装在物理内存中&#xff0c;需要对程序进行切片 虚拟…...

编程日记 2024/12/11 3:32:42

SparkSQL 读写数据攻略：从基础到实战

目录 一、输入Source 1&#xff09;代码演示最普通的文件读取方式&#xff1a; 2&#xff09; 通过jdbc读取数据库数据 3) 读取table中的数据【hive】 二、输出Sink 实战一&#xff1a;保存普通格式 实战二&#xff1a;保存到数据库中 实战三&#xff1a;将结果保存在h…...

编程日记 2024/12/11 3:30:40

react 使用状态管理调用列表接口渲染列表（包含条件查询，统一使用查询按钮，重置功能），避免重复多次调用接口的方法

react开发调用api接口一般使用useEffect来监听值的变化&#xff0c;通过值的变化与否来进行接口调用。 比如我们要进行一个查询接口 const [pageParams, setPage] useState({name: ,id: ,});const [dataList, setDataList] useState([]);const getList async () > {const…...

编程日记 2024/12/11 3:29:38

Stable Audio Open模型部署教程：用AI打造独家节拍，让声音焕发新活力！

Stable Audio Open 是一个开源的文本到音频模型&#xff0c;允许用户从简单的文本提示中生成长达 47 秒的高质量音频数据。该模型非常适合创建鼓点、乐器即兴演奏、环境声音、拟音录音和其他用于音乐制作和声音设计的音频样本。用户还可以根据他们的自定义音频数据微调模型&…...

编程日记 2024/12/11 3:25:30

加油站-（贪心算法）

题目描述 在一条环路上有 n 个加油站&#xff0c;其中第 i 个加油站有汽油 gas[i] 升。 你有一辆油箱容量无限的的汽车&#xff0c;从第 i 个加油站开往第 i1 个加油站需要消耗汽油 cost[i] 升。你从其中的一个加油站出发&#xff0c;开始时油箱为空。 给定两个整数数组 gas…...

编程日记 2024/12/11 3:24:29

k8s-持久化存储PV与PVC（1）

1、概述 为什么 kubernetes 要持久化存储&#xff1f; 在 kubernetes 中部署应用都是以 Pod 的容器运行的&#xff0c;而 Pod 是有生命周期&#xff0c;一旦 Pod 被删除或重启后&#xff0c;这些数据也会随着丢失&#xff0c;则需要对这些数据进行持久化存储。 PV&#xff1…...

编程日记 2024/12/11 3:20:26

Linux Red Hat Enterprise

下载 https://developers.redhat.com/products/rhel/download 安装...

编程日记 2024/12/11 3:18:24

《中型 Vue 项目：挑战与成长》

一、引言 在当今的前端开发领域&#xff0c;Vue 作为一款渐进式 JavaScript 框架&#xff0c;以其强大的功能和灵活性备受开发者青睐。对于中型 Vue 项目而言&#xff0c;其重要性不言而喻。中型 Vue 项目通常在功能复杂度和规模上介于小型项目和大型项目之间&#xff0c;既需要…...

编程日记 2024/12/11 3:17:22

配置 DNS over HTTPS阻止DNS污染

概念介绍 DOH简介 ​ DNS&#xff08;域名系统&#xff09;的主要功能是将域名解析成IP地址&#xff0c;域名的解析工作由DNS服务器完成。从安全角度来看&#xff0c;域名解析的请求传输时通常不进行任何加密&#xff0c;这导致第三方能够很容易拦截用户的DNS&#xff0c;将用…...

编程日记 2024/12/11 3:16:21

Facebook广告文案流量秘诀

Facebook 广告文案是制作有效 Facebook 广告的关键方面。它侧重于伴随广告视觉元素的文本内容。今天我们的博客将深入探讨成功的 Facebook 广告文案的秘密&#xff01; 一、广告文案怎么写&#xff1f; 正文&#xff1a;这是帖子的正文&#xff0c;出现在您姓名的正下方。它可…...

编程日记 2024/12/11 3:15:19

22. 五子棋小游戏

文章目录 概要整体架构流程技术名词解释技术细节小结 1. 概要 &#x1f50a; JackQiao 对 米粒 说&#xff1a;“今天咱们玩个五子棋小游戏&#xff0c;电脑与你轮流在一个 nn 的网格上放置棋子&#xff08;X 或 O&#xff09;&#xff0c;网格由你输入的正整数n决定&#xff0…...

编程日记 2024/12/11 3:13:17

fastadmin框架同时使用 阿里云oss和阿里云点播

背景 项目的实际需求中既要用到阿里云oss产品又用到阿里云点播系统&#xff0c;实现完美的统一。设置两个地址downUrl&#xff0c;thirdCode。分别代表阿里云oss上传路径和阿里云点播系统vId。 实现 默认框架你已经集成好阿里云oss集成工作&#xff0c;前端html页面实现 <…...

编程日记 2024/12/11 3:07:10

Java-JMX 组件架构即详解

JMX架构由三个主要组件构成&#xff1a; ‌MBeans&#xff08;Managed Beans&#xff09;‌&#xff1a;代表可管理的资源&#xff0c;是JMX的核心。MBean可以是Java类或接口&#xff0c;提供了管理操作的接口&#xff0c;如获取系统信息、设置参数等。‌MBeanServer‌&#x…...

编程日记 2024/12/11 3:01:03

unity打包web，发送post请求，获取地址栏参数，解决TypeError:s.replaceAll is not a function

发送post请求 public string url "http://XXXXXXXXX";// 请求数据public string postData "{\"user_id\": 1}";// Start is called before the first frame updatevoid Start(){// Post();StartCoroutine(PostRequestCoroutine(url, postData…...

编程日记 2024/12/11 3:00:01

java+ssm+mysql校园物品租赁网

项目介绍&#xff1a; 使用javassmmysql开发的校园物品租赁网&#xff0c;系统包含管理员、用户角色&#xff0c;功能如下&#xff1a; 管理员&#xff1a;用户管理&#xff1b;物品管理&#xff08;物品种类、物品信息、评论信息&#xff09;&#xff1b;订单管理&#xff1…...

编程日记 2024/12/11 2:57:59

Spring Boot中实现JPA多数据源配置指南

本文还有配套的精品资源&#xff0c;点击获取 简介&#xff1a;本文详细介绍了在Spring Boot项目中配置和使用JPA进行多数据源管理的步骤。从引入依赖开始&#xff0c;到配置数据源、创建DataSource bean、定义实体和Repository&#xff0c;最后到配置事务管理器和使用多数据…...

编程日记 2024/12/11 2:54:47

批量发短信接口的数据格式设计：CSV、JSON还是XML？

在开发者对接批量发短信接口的实际开发中&#xff0c;数据格式的选型是核心技术环节&#xff0c;CSV、JSON、XML三种主流格式各有技术特性&#xff0c;适配不同的业务场景。选品不当易导致数据解析效率低、接口调用失败、批量发送卡顿等问题。本文将从接口对接的核心诉求出发&a…...

编程新知 2026/3/26 2:02:58

空调智慧节能控制系统解决方案：一键部署，适配多场景节能需求

一、应用背景 当前&#xff0c;建筑能耗已成为社会总能耗的重要组成部分&#xff0c;其中空调系统能耗占比高达50%左右&#xff0c;尤其在商业综合体、高校、酒店、写字楼等大型建筑中&#xff0c;空调能耗过高、管理粗放的问题尤为突出。传统空调控制系统依赖人工操作&#xf…...

编程新知 2026/3/26 1:58:58

方寸之间 体验跃升 | 匠芯创D12x系列助力TCL洗烘一体机打造丝滑交互体验

近日&#xff0c;搭载匠芯创高性能显示控制MCU D12x系列&#xff08;D121BBV&#xff09;的TCL洗烘一体机T7W Max上市。其机身配备的1.8寸、分辨率360x360旋钮智慧屏&#xff0c;以顺畅的旋转手感与和灵动的界面动画&#xff0c;成为产品的亮点之一。 方寸旋钮 成就丝滑体验 旋…...

编程新知 2026/3/26 1:36:53

开源项目显卡兼容性避坑实战：CUDA版本适配与环境配置指南

开源项目显卡兼容性避坑实战&#xff1a;CUDA版本适配与环境配置指南 【免费下载链接】IsaacLab Unified framework for robot learning built on NVIDIA Isaac Sim 项目地址: https://gitcode.com/GitHub_Trending/is/IsaacLab 在开源项目开发过程中&#xff0c;显卡兼…...

编程新知 2026/3/26 1:14:45

直齿行星齿轮纯扭转非线性动力学建模与动力学方程推导研究：啮合相位对相图、频谱图、分岔图及庞加莱...

直齿行星齿轮纯扭转非线性动力学建模(含3个或4个行星轮)&#xff0c;包括动力学方程推导过程&#xff0c;考虑了各啮合齿轮副之间的啮合相位&#xff0c;可出相图&#xff0c;频谱图&#xff0c;分岔图&#xff0c;庞加莱映射。行星齿轮系统的非线性动力学分析总带着点机械工程…...

编程新知 2026/3/26 1:02:43

AlphaFold实战指南：如何利用Colab+开源代码复现蛋白质结构预测（避坑版）

AlphaFold实战指南&#xff1a;如何利用Colab开源代码复现蛋白质结构预测&#xff08;避坑版&#xff09; 蛋白质结构预测一直是计算生物学领域的圣杯级难题。2021年DeepMind发布的AlphaFold2以原子级精度解决了这一挑战&#xff0c;彻底改变了结构生物学的研究范式。本文将带你…...

编程新知 2026/3/26 0:56:42

SpringBoot实战：高效读取resources目录文件并实现安全下载

1. 为什么需要从resources目录读取文件&#xff1f; 在日常开发中&#xff0c;我们经常会遇到需要提供文件下载功能的场景。比如导出Excel报表、下载PDF合同、获取系统模板文件等。这些文件通常具有以下特点&#xff1a; 相对固定&#xff1a;内容不会频繁变动&#xff0c;比如…...

编程新知 2026/3/25 22:23:06

别再只盯着R和C了！芯片设计中的互连寄生参数，这3个实战场景下的模型选择与避坑指南

芯片设计实战&#xff1a;互连寄生参数模型选择的3个关键场景与避坑策略 在28nm及以下工艺节点的芯片设计中&#xff0c;互连寄生参数对时序收敛的影响已超过晶体管本身特性。当设计团队从RTL综合进入物理实现阶段&#xff0c;工程师们常常陷入这样的困境&#xff1a;明明STA报…...

编程新知 2026/3/25 20:51:58

别再只会用scatter画点图了！用Matlab给散点图加上‘密度滤镜’，数据洞察力瞬间翻倍

解锁数据可视化新维度&#xff1a;Matlab密度散点图的科研实战指南 当面对数十万地理坐标点或生物标记数据时&#xff0c;传统散点图往往会变成一团模糊的"墨迹"。我曾用三个月时间分析一组包含20万GPS轨迹点的城市人流数据&#xff0c;直到发现密度散点图这个神器—…...

编程新知 2026/3/25 20:47:57

打造Matlab人脸考勤系统（GUI）：深度学习的奇妙之旅

matlab人脸考勤系统(GUI),深度学习方法 源码详细注释 提供详细三千字帮助说明文档 GUI里的人脸识别算法&#xff1a;CNN&#xff0c;人脸检测方法VJ算法&#xff0c;可实现静态图像/实时图像的识别在当今数字化时代&#xff0c;考勤系统不断升级&#xff0c;基于深度学习的人脸…...

编程新知 2026/3/25 18:57:22