4

Spring Boot 2.x基础教程：实现文件上传

 3 years ago
source link: http://blog.didispace.com/spring-boot-learning-21-4-3/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

文件上传的功能实现是我们做Web应用时候最为常见的应用场景，比如：实现头像的上传，Excel文件数据的导入等功能，都需要我们先实现文件的上传，然后再做图片的裁剪，excel数据的解析入库等后续操作。

今天通过这篇文章，我们就来一起学习一下如何在Spring Boot中实现文件的上传。

动手试试

第一步：创建一个基础的Spring Boot项目，如果还不会的话就先看看这篇《快速入门》。

第二步：在 pom.xml 中引入模版引擎依赖： 

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-thymeleaf</artifactId>
</dependency>

你也可以选择其他你熟悉的模版引擎，比如：Freemarker。

第三步：在 resources 目录下，创建新目录 templates ；在 templates 目录下再创建一个文件上传的页面 upload.html ，内容如下： 

<!DOCTYPE html>
<html>
<head lang="en">
    <meta charset="UTF-8" />
    <title>文件上传页面</title>
</head>
<body>
<h1>文件上传页面</h1>
<form method="post" action="/upload" enctype="multipart/form-data">
    选择要上传的文件：<input type="file" name="file"><br>
    <hr>
    <input type="submit" value="提交">
</form>
</body>
</html>

第四步：创建文件上传的处理控制器，命名为UploadController 

@Controller
@Slf4j
public class UploadController {

    @Value("${file.upload.path}")
    private String path;

    @GetMapping("/")
    public String uploadPage() {
        return "upload";
    }

    @PostMapping("/upload")
    @ResponseBody
    public String create(@RequestPart MultipartFile file) throws IOException {
        String fileName = file.getOriginalFilename();
        String filePath = path + fileName;

        File dest = new File(filePath);
        Files.copy(file.getInputStream(), dest.toPath());
        return "Upload file success : " + dest.getAbsolutePath();
    }

}

其中包含这几个重要元素：

  1. 成员变量 path ，通过 @Value 注入配置文件中的 file.upload.path 属性。这个配置用来定义文件上传后要保存的目录位置。
  2. GET请求，路径 / ，用于显示 upload.html 这个文件上传页面。
  3. POST请求。路径 /upload ，用于处理上传的文件，即：保存到 file.upload.path 配置的路径下面。

注意：这里主要演示文件上传的主要流程，真实应用还有更多内容要考虑，比如：文件上传后的文件名处理（防止重名）、分布式情况下文件上传后如何共享访问等。更高级的最后，我们后续文章继续讲。

第五步：编辑 application.properties 配置文件 

spring.servlet.multipart.max-file-size=2MB
spring.servlet.multipart.max-request-size=2MB

file.upload.path=/Users/didi/

前两个参数用于限制了上传请求和上传文件的大小，而 file.upload.path 是上面我们自己定义的用来保存上传文件的路径。

更多本系列免费教程连载「点击进入汇总目录」

测试验证

第一步：启动Spring Boot应用，访问 http://localhost:8080 ，可以看到如下的文件上传页面。

7feiuq2.png!mobile

第二步：选择一个不大于2MB的文件，点击“提交”按钮，完成上传。

如果上传成功，将显示类似下面的页面：

EJf6Vfq.png!mobile

你可以根据打印的文件路径去查看文件是否真的上传了。

代码示例

本文的相关例子可以查看下面仓库中的 chapter4-3 目录：

如果您觉得本文不错，欢迎 Star 支持，您的关注是我坚持的动力！


report

Recommend

About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK