百度360必应搜狗淘宝本站头条
mysql distinctjenkins官网mysql 子查询vba splitpython list sort
当前位置：网站首页 > IT技术 > 正文

SpringBoot的Web应用开发——文件上传!

wptr33 2025-08-02 22:16 3 浏览

文件上传

在项目开发中，文件上传是很常见的功能，如用户上传头像、上传自己

喜欢的图片、上传Excel文件等。本节将介绍如何使用Spring Boot中自带的

上传功能完成文件的上传。

实战：使用J2EE实现文件上传

新建一个FileController.java文件，将其作为上传文件的请求入口，代码如下：

package com.example.thymeleafdemo.controller;

import org.springframework.stereotype.Controller;

import org.springframework.ui.Model;

import org.springframework.util.FileCopyUtils;

import org.springframework.web.bind.annotation.*;

import org.springframework.web.multipart.MultipartFile;

import java.io.*;

@Controller

public class FileController {

/**

* 去文件上传的页面

*/

@GetMapping("toUpload")

public String toUpload() {

return "toUpload";

}

/**

* 上传一个文件

*/ @PostMapping("/uploadFile")

public String SingleFileUpLoad(@RequestParam("myfile")

MultipartFile file,

Model model) {

//判断文件是否为空

if (file.isEmpty()) {

model.addAttribute("result_singlefile", "文件为空");

return "toUpload";

}

//指定上传的位置为 d:/upload/

String path = "d:/upload/";

try {

//获取文件的输入流

InputStream inputStream = file.getInputStream();

//获取上传时的文件名

String fileName = file.getOriginalFilename();

//注意是路径+文件名

File targetFile = new File(path + fileName);

//如果之前的 String path = "d:/upload/" 没有在最后加 / ，那就要

在 path后面 + "/"

//判断文件父目录是否存在

if (!targetFile.getParentFile().exists()) {

//不存在就创建一个

targetFile.getParentFile().mkdir();

}

//获取文件的输出流

OutputStream outputStream = new

FileOutputStream(targetFile);

//最后使用资源访问器FileCopyUtils的copy方法拷贝文件

FileCopyUtils.copy(inputStream, outputStream);

//告诉页面上传成功了

model.addAttribute("uploadResult", "上传成功");

} catch (Exception e) {

model.addAttribute("uploadResult", "上传失败");

}

return "toUpload";

}

}

完成上传文件的非空校验后，把上传文件复制到本地存放文件的目录下，最后返回保存文件的URI，数据库只保存文件的路径。

在templates目录下新建upUpload.html文件，将其作为上传文件的页面，代码如下：

<!DOCTYPE html>

<html xmlns:th="http://www.thymeleaf.org">

<head>

<meta charset="UTF-8">

<title>文件上传页面</title>

</head>

<body>

<h1>文件上传</h1>

<form class="form-signin" th:action="@{/uploadFile}" method="post"

enctype="multipart/form-data">

<p><input type="file" name="myfile"/></p>

<p><input type="submit" value="上传"/></p>

<p style="color: red" th:text="${uploadResult}" th:if="${not

#strings.

isEmpty(uploadResult)}"></p>

</form>

</body>

</html>

修改application.properties，设置请求文件的大小。

#文件上传的配置

spring.servlet.multipart.max-file-size=10MB

spring.servlet.multipart.max-request-size=10MB

启动服务器，访问
http://localhost:8080/toUpload，将显示上传文件的页面，如图4.3所示。

单击“选择文件”按钮，弹出“选择文件”对话框，选择文件之后，单击“上传”按钮就能将文件上传到本地服务器的D:/upload中。上传完成后，页面会提示“上传成功”字样，如图4.4所示。

解析文件上传的源码

前面完成了文件上传的功能，下面对文件上传功能的源码进行简单的解析。Spring Boot项目启动时会加载上传的配置文件，其配置类为
MultipartAutoConfiguration，源码如下：

@Configuration(proxyBeanMethods = false)

@ConditionalOnClass({Servlet.class,StandardServletMultipartResolver.class, MultipartConfigElement.class })

@ConditionalOnProperty(prefix = "spring.servlet.multipart", name =

"enabled", matchIfMissing = true)

@ConditionalOnWebApplication(type = Type.SERVLET)

@EnableConfigurationProperties(MultipartProperties.class)

public class MultipartAutoConfiguration {

private final MultipartProperties multipartProperties;

public MultipartAutoConfiguration(MultipartProperties multipart

Properties) {

this.multipartProperties = multipartProperties;

}

@Bean

@ConditionalOnMissingBean({MultipartConfigElement.class, Commons

MultipartResolver.class })

public MultipartConfigElement multipartConfigElement() {

return this.multipartProperties.createMultipartConfig();

}

@Bean(name = DispatcherServlet.MULTIPART_RESOLVER_BEAN_NAME)

@ConditionalOnMissingBean(MultipartResolver.class)

public StandardServletMultipartResolver multipartResolver() {

StandardServletMultipartResolver multipartResolver=new Standard

ServletMultipartResolver();

multipartResolver.setResolveLazily(this.multipartProperties.isResolveL

azily());

return multipartResolver;

}

}


MultipartAutoConfiguration类中的

@ConditionalOnClass({Servlet.class, Standard

ServletMultipartResolver.class, MultipartConfigElement.class })

表示只有在特定的类加载后才使用，通过@
EnableConfigurationProperties开启自动配置的文件，如果配置文件缺失时默认
spring.http.multipart.enabled为true，则说明在Spring中文件上传功能是默认启用的。通过@
EnableConfigurationProperties(MultipartProperties.class)可以查看自定义的上传配置，查看MultipartProperties类就可以看到部分源码如下：

@ConfigurationProperties(prefix = "spring.servlet.multipart", ignore

UnknownFields = false)

public class MultipartProperties {

/**

* Whether to enable support of multipart uploads.

*/

private boolean enabled = true;

/**

* Intermediate location of uploaded files.

*/

private String location;

/**

* Max file size.

*/

private DataSize maxFileSize = DataSize.ofMegabytes(1);

/**

* Max request size.

*/

private DataSize maxRequestSize = DataSize.ofMegabytes(10);

/**

* Create a new {@link MultipartConfigElement} using the properties.

* @return a new {@link MultipartConfigElement} configured using

there

properties

*/

public MultipartConfigElement createMultipartConfig() {

MultipartConfigFactory factory = new MultipartConfigFactory();

PropertyMapper map =

PropertyMapper.get().alwaysApplyingWhenNonNull();

map.from(this.fileSizeThreshold).to(factory::setFileSizeThreshold);

map.from(this.location).whenHasText().to(factory::setLocation);

map.from(this.maxRequestSize).to(factory::setMaxRequestSize);

map.from(this.maxFileSize).to(factory::setMaxFileSize);

return factory.createMultipartConfig();

}

}

这里就是把在自定义的application.properties中配置的值注入当前配置类中，查看createMultipartConfig()方法，该方法是通过MultipartConfigFactory 来设置上传的配置项。当配置类加载完成后，会创建处理的组件，就是
MultipartAutoConfiguration这个类的

multipartResolver方法，代码如下：

@Bean(name = DispatcherServlet.MULTIPART_RESOLVER_BEAN_NAME)

@ConditionalOnMissingBean(MultipartResolver.class)

public StandardServletMultipartResolver multipartResolver() {

StandardServletMultipartResolver multipartResolver = new Standard

ServletMultipartResolver();

multipartResolver.setResolveLazily(this.multipartProperties.isResolveL

azily());

return multipartResolver;

}

multipartResolver()方法用于选择哪一个实现类，默认情况下使用的是
StandardServlet-MultipartResolver类。可以通过MultiparResolver来了解一下有哪些部件。在Servlet 3.0之前Spring提供的默认附件解析器是MultipartResoler，实现类是CommonsMultipartResolver，它是基于CommonsFile Upload的第三方实现的，在目前最新的Servlet版本中使用的是
StandardServletMultipartResolver，其实现源码如下：

public class StandardServletMultipartResolver implements Multipart

Resolver {

private boolean resolveLazily = false;

/**

* Set whether to resolve the multipart request lazily at the time

of

* file or parameter access.

* <p>Default is "false", resolving the multipart elements

immediately, throwing

* corresponding exceptions at the time of the {@link

#resolveMultipart} call.

* Switch this to "true" for lazy multipart parsing, throwing parse

exceptions

* once the application attempts to obtain multipart files or

parameters.

* @since 3.2.9

*/

public void setResolveLazily(boolean resolveLazily) {

this.resolveLazily = resolveLazily;

}

@Override

public boolean isMultipart(HttpServletRequest request) {

return

StringUtils.startsWithIgnoreCase(request.getContentType(),"multipart/"

);

}

@Override

public MultipartHttpServletRequest

resolveMultipart(HttpServletRequest request) throws MultipartException

{

return new StandardMultipartHttpServletRequest(request,

this.resolveLazily);

}

@Override

public void cleanupMultipart(MultipartHttpServletRequest request) {

if (!(request instanceof AbstractMultipartHttpServletRequest) ||

((AbstractMultipartHttpServletRequest)

request).isResolved()) { // To be on the safe side: explicitly delete the parts,

// but only actual file parts (for Resin compatibility)

try {

for (Part part : request.getParts()) {

if (request.getFile(part.getName()) != null) {

part.delete();

}

}

}

catch (Throwable ex) {

LogFactory.getLog(getClass()).warn("Failed to perform

cleanup of multipart items", ex);

}

}

}

}

至此完成了文件上传的代码解析，这里只是简单的讲解，如果读者有兴趣，可以在类上设置断点，一步一步地跟踪代码，最后完成整个代码流程的跟踪。

注意：在跟踪代码时可以忽略一些不重要的点，有目的性地查看，多跟踪几遍后就会对源码非常熟悉了。

相关推荐

Windows10 编译OpenCV4.5源码

在OpenCV4.5+VisualStudio2017开发环境配置...

什么是OpenCV?有哪些基础图像处理操作?

一、OpenCV简介OpenCV是一款由Intel公司俄罗斯团队发起并参与和维护的一个计算机视觉处理开源软件库，支持与计算机视觉和机器学习相关的众多算法，并且正在日益扩展。...

学习Opencv-第9节-读写图像

1、读图像---imread()Matimread(conststring&filename,ingflags=1)定义中包含两个参数，一个图像文件名，一个flag标志位，返回的是一个Ma...

基于opencv的视觉巡线实现

前言这段时间在和学弟打软件杯的比赛，有项任务就是机器人的视觉巡线，这虽然不是什么稀奇的事情，但是对于一开始不了解视觉的我来说可以说是很懵了，所以现在就想着和大家分享一下，来看看是如何基于opencv来...

OpenCV学习之图像读取与显示

1、OpenCV的特点（1）总体描述...

OpenCV+Python裁剪图像

最近使用OpenCV+Python做了一个程序，功能是自动将照片中的文本部分找出来并裁剪/旋转保存为新的图片。这个功能用专业些的说法就是选择并提取感兴趣区域（ROI（RegionofInteres...

OpenCV-Python速查表:从导入图像到人脸检测

——本文对图像裁剪、调整大小、旋转、阈值、模糊、在图像上绘图和书写、人脸检测和使用轮廓图像检测对象都进行了解释。什么是OpenCV-Python?OpenCV是一个开源的计算机视觉（computer...

Python图像处理:OpenCV基础教程

OpenCV（OpenSourceComputerVisionLibrary）是一个开源计算机视觉和机器学习软件库。它提供了大量的图像和视频处理功能，可以用于各种应用场景，比如人脸识别、物体检...

OpenCV学堂深度学习系统化学习路线图专题(2023版)

参考资料：aixuetang.xyz/15842...

OpenCV4系统化学习路线图与教程

获课：bcwit.top/15489...

使用OpenCV库操作摄像头拍照、调节参数和视频录制

需求使用OpenCV做功能，播放摄像头（usb和网络），对摄像头设备进行参数调整（亮度、对比度、饱和度、色调、增益、曝光度）调节，拍照和录像。原理使用OpenCV打开摄像头（可打开USB和网路哦摄像...

Python图像处理:用OpenCV实现照片的趣味特效与编辑!

在当今数字化时代，图像处理已经成为了我们生活中不可或缺的一部分，无论是社交媒体上的照片美化，还是专业领域的图像分析，都离不开图像处理技术。Python作为一门强大的编程语言，搭配OpenCV库，为我们...

OpenCV-1: 读取图片，显示图片，保存图片

目标1在这里，将学习如何读取图像，如何显示图像以及如何将其保存回去将学习以下功能：...

JAVA学习笔记——fileUpload文件上传

一、什么是fileUpload?fileUpload是apache的commons组件提供的上传组件，它最主要的工作就是帮我们解析request.getInpustream()。可以参考在线API文档...

如何在Windows10中配置java的JDK环境

今天给大家分享一下如何配置java的JDK环境。操作步骤如下：1.下载好jdk的安装文件，我下载的是jdk-10.0.1_windows-x64_bin.exe这个版本的安装文件；2.使用鼠标...

一周热门
最近发表
标签列表
赣ICP备2024040476号-12