跳至主要內容

文件上传

LiAngJava2023年11月17日SpringBootJava大约 6 分钟约 1181 字

应用实例

演示 Spring-Boot 通过表单注册用户，并支持上传图片。

代码实现

创建 src/main/resources/templates/upload.html

（头像只能上传一个，宠物可以上传多个）

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="UTF-8">
    <title>upload</title>
</head>
<body bgcolor="#CED3FE">
<img src="images/1.GIF"/>
<hr/>
<div style="text-align: center">
    <h1>注册用户~</h1>
    <form action="#" th:action="@{/upload}" method="post" enctype="multipart/form-data">
        用户名:<input type="text" style="width:150px" name="name"/><br/><br/>
        电　邮:<input type="text" style="width:150px" name="email"/><br/><br/>
        年　龄:<input type="text" style="width:150px" name="age"/><br/><br/>
        职　位:<input type="text" style="width:150px" name="job"/><br/><br/>
        头　像:<input type="file" style="width:150px" name="header"><br/><br/>
        宠　物:<input type="file" style="width:150px" name="photos" multiple><br/><br/>
        <input type="submit" value="注册"/>
        <input type="reset" value="重新填写"/>
    </form>
</div>
<hr/>
<img src="images/logo.png"/>
</body>
</html>

创建 src/main/java/com/lzw/springboot/controller/UploadController.java

package com.lzw.springboot.controller;

import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Controller;
import org.springframework.util.ResourceUtils;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.IOException;

/**
 * @author LiAng
 */
@Controller
@Slf4j
public class UploadController {
    //处理转发到用户注册-可以完成文件上传页面
    @GetMapping("/upload.html")
    public String uploadPage() {
        return "upload";// 视图解析,转发到templates/upload.html
    }

    //处理用户的注册请求-包括处理文件上传
    @PostMapping("/upload")
    @ResponseBody
    public String upload(@RequestParam("name") String name, @RequestParam("email") String email,
                         @RequestParam("age") Integer age, @RequestParam("job") String job,
                         @RequestParam("header") MultipartFile header,
                         @RequestParam("photos") MultipartFile[] photos) throws IOException {
        //输出获取到的信息
        log.info("上传的信息 name={} email={} age={} job={} header={} photos={} ",
                name, email, age, job, header.getSize(), photos.length);

        //如果信息都成功得到，我们就将文件保存到指定的目录,比如d:\\temp_upload
        //1. 我们先将文件保存到指定的目录 比如d:\\temp_upload
        //2. 后面我们在演示把文件保存到动态创建的目录.
        //   比如: D:\Study\VIP\AllDemo\SpringBoot\springboot-usersys\target\classes\static\images\xupload

        //得到类路径（运行的时候）
        String path = ResourceUtils.getURL("classpath:").getPath();
        log.info("path={}", path);

        //动态创建指定目录
        File file = new File(path + "static/images/upload");
        if(!file.exists()){//判断路径存在
            file.mkdirs();
        }


        if(!header.isEmpty()){//处理头像
            String originalFilename = header.getOriginalFilename();
            //header.transferTo(new File("d:\\temp_upload\\" + originalFilename));

            //log.info("保存文件的绝对路径={}" + file.getAbsolutePath());
            //D:\Study\VIP\AllDemo\SpringBoot\springboot-usersys\target\classes\static\images\xupload

            header.transferTo(new File(file.getAbsoluteFile() + "/" + originalFilename));

        }

        //处理宠物图片
        if(photos.length > 0){
            for (MultipartFile photo : photos) {
                if(!photo.isEmpty()){
                    String originalFilename = photo.getOriginalFilename();
                    //photo.transferTo(new File("d:\\temp_upload\\" + originalFilename));
                    photo.transferTo(new File(file.getAbsoluteFile() + "/" + originalFilename));
                }
            }
        }

        return "注册用户成功/文件上传成功";

    }

}

修改 WebConfig.java

	//第二种方式
    @Bean
    public WebMvcConfigurer webMvcConfigurer(){

        return new WebMvcConfigurer() {
            @Override
            public void addInterceptors(InterceptorRegistry registry) {
                System.out.println("addInterceptors~~~");
                //注册拦截器
                registry.addInterceptor(new LoginInterceptor())
                        .addPathPatterns("/**")
                        .excludePathPatterns("/","/login","/images/**","/upload.html","/upload");
            }
        };
    }

根据项目需求修改文件上传的参数

否则文件上传会抛出异常

image-20220808104759495
image-20220808104759495

创建 src/main/resources/application.yml

单个文件最大10MB，多个文件最大50MB

spring:
  servlet:
    multipart:
      max-file-size: 10MB
      max-request-size: 50MB

作业

1、解决文件覆盖问题，如果文件名相同，会出现覆盖问题。

2、解决文件分目录存放问题, 如果将文件都上传到一个目录下，当上传文件很多时，会造成访问文件速度变慢，因此可以将文件上传到不同目录比如一天上传的文件，统一放到一个文件夹 年/月/日，比如 2022/11/11 目录。

创建 src/main/java/com/lzw/springboot/utils/WebUtils.java

package com.lzw.springboot.utils;

import javax.servlet.http.HttpServletRequest;
import java.text.SimpleDateFormat;
import java.time.LocalDateTime;
import java.util.Date;

/**
 * @author LiAng
 */
public class WebUtils {

    //定义一个文件上传的路径常量
    public static String UPLOAD_FILE_DIRECTORY = "static/images/upload/";

    //编写方法生成一个目录，根据 年/月/日
    public static String getUploadFileDirectory(){
        return UPLOAD_FILE_DIRECTORY + new SimpleDateFormat("yyyy/MM/dd").format(new Date());
    }
}

修改 UploadController.java

    //处理用户的注册请求-包括处理文件上传
    @PostMapping("/upload")
    @ResponseBody
    public String upload(@RequestParam("name") String name, @RequestParam("email") String email,
                         @RequestParam("age") Integer age, @RequestParam("job") String job,
                         @RequestParam("header") MultipartFile header,
                         @RequestParam("photos") MultipartFile[] photos) throws IOException {
        //输出获取到的信息
        log.info("上传的信息 name={} email={} age={} job={} header={} photos={} ",
                name, email, age, job, header.getSize(), photos.length);

        //如果信息都成功得到，我们就将文件保存到指定的目录,比如d:\\temp_upload
        //1. 我们先将文件保存到指定的目录 比如d:\\temp_upload
        //2. 后面我们在演示把文件保存到动态创建的目录.
        //   比如: D:\Study\VIP\AllDemo\SpringBoot\springboot-usersys\target\classes\static\images\xupload

        //得到类路径（运行的时候）
        String path = ResourceUtils.getURL("classpath:").getPath();
        log.info("path={}", path);

        //动态创建指定目录
        File file = new File(path + WebUtils.getUploadFileDirectory());
        if(!file.exists()){//判断路径存在
            file.mkdirs();
        }

        if(!header.isEmpty()){//处理头像
            String originalFilename = header.getOriginalFilename();
            String fileName = UUID.randomUUID().toString() + "_" + System.currentTimeMillis() + "_" + originalFilename;
            //header.transferTo(new File("d:\\temp_upload\\" + originalFilename));
            //log.info("保存文件的绝对路径={}" + file.getAbsolutePath());
            //D:\Study\VIP\AllDemo\SpringBoot\springboot-usersys\target\classes\static\images\xupload
            header.transferTo(new File(file.getAbsoluteFile() + "/" + fileName));

        }

        //处理宠物图片
        if(photos.length > 0){
            for (MultipartFile photo : photos) {
                if(!photo.isEmpty()){
                    String originalFilename = photo.getOriginalFilename();
                    String fileName = UUID.randomUUID().toString() + "_" + System.currentTimeMillis() + "_" + originalFilename;
                    //photo.transferTo(new File("d:\\temp_upload\\" + originalFilename));
                    photo.transferTo(new File(file.getAbsoluteFile() + "/" + fileName));
                }
            }
        }

        return "注册用户成功/文件上传成功";
    }
上次编辑于: 2023/11/17 23:15:22
贡献者: LiAng