SpringBoot文件上传（九）

2019-04-18 本文已影响3人 3d0829501918

一、前言

1.上传文件是互联网中应用的场景之一,最典型的情况就是上传头像等。文件上传主要是将文件通过IO流传输到服务器的某一个特定的文件夹下。

2.上传文件，必须将表单method设置为post，并将enctype设置为multipart/form-data。只有这样，浏览器才会把用户所选文件的二进制数据发送给服务器。SpringMVC在文件上传时，会将上传的文件映射为MultipartFile对象，并对MultipartFile对象进行文件的解析和保存。

二、MultipartFile接口的方法

byte[ ] getBytes( )：获取文件数据

String getContentType( )：获取文件MIME类型，如application/pdf、image/pdf等

InputStream getInputStream( )：获取文件流

String getOriginalFileName( )：获取上传文件的原名称

long getSize( )：获取文件的字节大小，单位为byte

boolean isEmpty( )：是否有上传的文件

void transferTo(File dest)：将上传的文件保存到一个目标文件中。

三、简单配置

3.1 引入pom.xml内容
引入了spring-boot-starter-thymeleaf做页面模板引擎，写一些简单的上传示例。

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

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

3.2 application.properties配置文件

#thymeleaf
spring.thymeleaf.prefix=classpath:/templates/
spring.thymeleaf.suffix=.html
spring.thymeleaf.mode=LEGACYHTML5
spring.thymeleaf.encoding=UTF-8
spring.thymeleaf.content-type=text/html
# 禁用 thymeleaf 缓存
spring.thymeleaf.cache=false

# 上传文件总的最大值
spring.servlet.multipart.max-request-size=10MB
# 单个文件的最大值
spring.servlet.multipart.max-file-size=10MB
# 是否支持批量上传   (默认值 true)
spring.servlet.multipart.enabled=true
# 上传文件的临时目录 （一般情况下不用特意修改）
spring.servlet.multipart.location=
# 文件大小阈值，当大于这个阈值时将写入到磁盘，否则存在内存中，（默认值0 一般情况下不用特意修改）
spring.servlet.multipart.file-size-threshold=0
# 判断是否要延迟解析文件（相当于懒加载，一般情况下不用特意修改）
spring.servlet.multipart.resolve-lazily=false

3.3 static和templates介绍

在src/main/resources目录下新建static目录和templates目录。SpringBoot官方文档告诉我们，statis这个目录里面应该存放一些静态文件，比如 css、js、image并且可以直接被外部访问到。而templates这个目录则存放一些静态页面，如jsp、html、ftl。并且template这个目录里的内容外部是访问不到的。按照规范，我们将singleFile.html和multipleFiles文件放到templates目录下。

四、单文件上传

4.1创建单文件singleFile.html页面

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
<p>单文件上传</p>
<form method="POST" enctype="multipart/form-data" action="upload" >
    文件：<input type="file" name="file"/>
    <input type="submit"/>
</form>
<hr/>
</body>
</html>

4.2 在控制层FileUploadController中添加singleFile方法

@PostMapping("/singleFile")
@ResponseBody
public String singleFile(@RequestParam("file") MultipartFile file) {
    //判断非空
    if (file.isEmpty()) {
        return "上传的文件不能为空";
    }
    try {
        // 测试MultipartFile接口的各个方法
        LOGGER.info("[文件类型ContentType] - [{}]",file.getContentType());
        LOGGER.info("[文件组件名称Name] - [{}]",file.getName());
        LOGGER.info("[文件原名称OriginalFileName] - [{}]",file.getOriginalFilename());
        LOGGER.info("[文件大小] - [{}]",file.getSize());
        //文件路径
        String path = "D:\\Program Files\\upload\\";
        LOGGER.info(this.getClass().getName()+"图片路径："+path);
        File f = new File(path);
        //如果不存在该路径就创建
        if (!f.exists()) {
            f.mkdir();
        }
        File dir = new File(path + file.getOriginalFilename());
        // 文件写入
        file.transferTo(dir);
        return "上传单个文件成功";
    } catch (Exception e) {
        e.printStackTrace();
        return "上传单个文件失败";
    }
}

4.3 测试
启动项目，输入http://localhost:8080/singleFile，进入上传单文件页面，然后选择要上传的图片。如下图：

我选择文件名称为瓜子二手车的图片，然后点击提交按钮返回成功信息。然后看上传的结果以及图片地址。

这样单文件上传就完成了。

五、多文件上传

多文件上传页面只是比单文件上传多了file选择的input而已，multipleFiles内容如下：

5.1创建multipleFiles.html页面

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>

<p>多文件上传</p>
<form method="POST" enctype="multipart/form-data" action="multipleFiles">
    <p>文件1：<input type="file" name="file"/></p>
    <p>文件2：<input type="file" name="file"/></p>
    <p><input type="submit" value="上传"/></p>
</form>
</body>
</html>

5.2 在控制层FileUploadController添加multipleFiles方法

@PostMapping("/multipleFiles")
@ResponseBody
public String multipleFiles(@RequestParam("file") MultipartFile[] files, HttpServletRequest request) {
    //List<MultipartFile> files = ((MultipartHttpServletRequest) request).getFiles("file");
    if (null == files && files.length == 0) {
        return null;
    }
    String filePath = "D:\\Program Files\\upload\\";
    for (MultipartFile mf : files) {
        //文件名称
        String filename = mf.getOriginalFilename();
        if (mf.isEmpty()) {
            return "文件名称："+ filename +"上传失败，原因是文件为空!";
        }
        File dir = new File(filePath + filename);

        try {
            //写入文件
            mf.transferTo(dir);
            LOGGER.info("文件名称："+ filename +"上传成功");
        } catch (IOException e) {
            LOGGER.error(e.toString(), e);
            return "文件名称："+ filename +"上传失败";
        }
    }
    return "多文件上传成功";

5.3测试
启动项目，输入http://localhost:8080/multipleFiles，进入上传多文件的页面，如下图：