SpringBoot系列教程-Web开发04之实现文

SpringBoot系列教程-Web开发04之实现文件上传

. 概述

文件上传是开发中比较常见的功能之一.但是SpringBoot并没有提供特别的文件上传技术,而是依赖于SpringMVC的文件上传技术.在SpringBoot中集成了SpringMVC的很多常用功能,也包含了文件上传部分,实现起来没有太多的区别.

本章节我们就讲解如何在Spring Boot中实现文件文件上传.

1. MultipartFile简介

在SpringMVC时代,提供了MultipartFile这个封装类,它包含了文件的二进制流和文件相关属性(文件名、大小等),而在Spring Boot中也是使用此封装类进行文件上传的.

MultipartFile是个接口,它的实现类有CommonsMultipartFile和StandardMultipartFile,这里简单说明:

1??. CommonsMultipartFile: 是基于apache fileupload的解析;

2??. StandardMultipartFile: 是基于j2ee自带的文件上传进行解析,也就是使用Servlet3.0提供的javax.servlet.http.Part上传方式.

我们在正常使用MultipartFile时,无需关心底层是以哪种方式进行文件上传处理的,SpringMVC会给我们做相应的转换.

byte[] getBytes(): 获取文件数据;
String getContentType(): 获取文件MIME类型,如application/pdf、image/pdf等;
InputStream getInputStream(): 获取文件流;
String getOriginalFileName(): 获取上传文件的原名称;
long getSize(): 获取文件的字节大小,单位为byte;
boolean isEmpty(): 是否上传的文件是否为空;
void transferTo(File dest): 将上传的文件保存到目标文件中

2. 注意:

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

二. 使用SpringBoot上传单个文件

1. 在原有项目中创建一个新的module?

2. 改造pom.xml文件，添加相关依赖包

<dependencies>
    <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>

    <!--为了解决thymeleaf模板中,对html标签要求太严格的问题!-->
    <dependency>
        <groupId>net.sourceforge.nekohtml</groupId>
        <artifactId>nekohtml</artifactId>
        <version>1.9.22</version>
    </dependency>

    <!--简化bean的代码-->
    <dependency>
        <groupId>org.projectlombok</groupId>
        <artifactId>lombok</artifactId>
    </dependency>
</dependencies>

3. 编写文件上传页面picUpload.html

在resource/templates目录下，创建一个文件上传页面。

<!DOCTYPE HTML>
<html>
<head>
    <title>pictureUploading</title>
    <meta http-equiv="Content-Type" content="text/html;charset=UTF-8">
</head>
<body>
<form enctype="multipart/form-data" method="post" action="/upload">
    文件: <input type="file" name="fileUpload"/>
    <input type="submit" value="上传"/>
</form>
</body>
</html>

4. 配置application.properties

在resources目录下，创建一个application.properties配置文件，并设置相关配置属性。

# Template mode to be applied to templates. See also StandardTemplateModeHandlers.
spring.thymeleaf.mode=LEGACYHTML5

spring.servlet.multipart.enabled=true
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=10MB

#文件上传目录（注意Linux和Windows上的目录结构不同）
#uploadFolder=/root/upload/
#特别要注意此位置
uploadFolder=E:/upload/

5. 创建信息提示类Message

创建项目包，在包里创建一个JavaBean，用于对外展示信息。

package com.yyg.boot.domain;

import lombok.AllArgsConstructor;
import lombok.Data;
import lombok.NoArgsConstructor;

/**
 * 采用lombok简化bean
 */
@Data
@NoArgsConstructor
@AllArgsConstructor
public class Message {

    /**
     *0表示成功,-1表示失败
     */
    int status;

    /**
     * 向前端返回的内容
     */
    String massage;

}

6. 创建文件上传的UploadController类

package com.syc.boot.web;

import com.syc.boot.domain.Message;
import org.springframework.beans.factory.annotation.Value;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.ResponseBody;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.util.UUID;

/**
 * 实现文件上传的控制器
 */
@Controller
public class UploadController {

    @Value("${uploadFolder}")
    private String  fileDir;

    @RequestMapping("/picUpload")
    public String picUpload(){
        //跳转到picUpload.html
        return "picUpload";
    }

    @ResponseBody
    @PostMapping("/upload")
    public Object upload(MultipartFile fileUpload){
        //获取文件名
        String fileName=fileUpload.getOriginalFilename();
        //获取文件后缀名
        String suffixName=fileName.substring(fileName.lastIndexOf("."));
        //重新生成文件名
        fileName=UUID.randomUUID()+suffixName;
        //指定本地文件夹存储图片
        try {

            System.out.println("------->>"+fileDir);
            File dir=new File(fileDir);
            if (!dir.exists()) {
                dir.mkdirs();
            }
            File upload_file=new File(fileDir + fileName);
            fileUpload.transferTo(upload_file);
            return new Message(0,"success to upload");
        } catch (Exception e) {
            e.printStackTrace();
            return new Message(-1,"fail to upload");
        }
    }
}

7. 应用程序入口类

package com.syc.boot;

import org.springframework.boot.SpringApplication;
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication
public class UploadWebApplication {

    public static void main(String[] args) {
        SpringApplication.run(UploadWebApplication.class, args);
    }
}

8. 运行程序,实现文件上传

我们接下来启动程序，访问文件上传界面，选择文件进行上传，可以看到如下效果，说明文件上传成功。

9. 整个工程目录结构

三. 使用SpringBoot上传多个文件

我们有时候需要同时上传多个文件，那么如何实现呢？

1. 创建多文件上传的html页面

我们首先创建一个多文件上传的html页面multiUpload.html。

<!DOCTYPE html>
<html xmlns:th="http://www.thymeleaf.org">
<head>
    <title>多文件上传</title>
    <meta charset="utf-8"/>
    <meta http-equiv="X-UA-Compatible" content="IE=edge"/>
    <meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=no"/>
</head>

<body>
<div>
    <div>
        <div>
            <h3>多个文件上传</h3>
        </div>
        <div>
            <form  method="post" enctype="multipart/form-data" th:action="@{/uploadMultifile}">
                <div>
                    <label for="attachment1">文件上传: </label>
                    <div>
                        <input type="file"  name="attachment" id="attachment1" placeholder="请选择邮件附件"/>
                    </div>
                </div>
                <div>
                    <label for="attachment2">文件上传: </label>
                    <div class="col-sm-5">
                        <input type="file"  name="attachment" id="attachment2" placeholder="请选择邮件附件"/>
                    </div>
                </div>
                <div>
                    <label for="attachment3">文件上传: </label>
                    <div>
                        <input type="file" name="attachment" id="attachment3" placeholder="请选择邮件附件"/>
                    </div>
                </div>

                <div>
                    <div>
                        <button type="submit">上 传</button>
                    </div>
                </div>
            </form>
        </div>
    </div>
</div>
</body>

</html>

2. 创建一个多文件上传的方法

要实现多文件上传,可以在上面的controller中添加一个新的接口方法.

@RequestMapping("/multiUpload")
    public String multiUpload(){
        //跳转到multiUpload.html
        return "multiUpload";
    }

@RequestMapping(value="/uploadMultifile", method=RequestMethod.POST)
    @ResponseBody
    public Object uploadMultiFile(@RequestParam("attachment") MultipartFile[] fileUpload) {
        
        try {
            for (int i=0;i<fileUpload.length;i++){
                //获取文件名
                String fileName=fileUpload[i].getOriginalFilename();
                //指定本地文件夹存储图片
                File dir=new File(fileDir);
                if (!dir.exists()) {
                    dir.mkdirs();
                }
                if (fileUpload[i]!=null){
                    File upload_file=new File(fileDir + fileName);
                    fileUpload[i].transferTo(upload_file);
                }
            }
            return new Message(0,"success to upload");
        } catch (Exception e) {
            e.printStackTrace();
            return new Message(-1,"fail to upload");
        }
        
    }

3. 多文件上传验证

我们最终实现了在Spring Boot中的多文件上传功能.

四. 总结下文件上传的要点：

1??. 表单method设置为post,并将enctype设置为 multipart/form-data;
2??. 文件映射为MultipartFile对象进行解析;
3??. 上传文件大小spring.http.multipart.max-file-size限制.

者：蓝色的秋风

转发链接：https://mp.weixin.qq.com/s/cruL9JGZNZQFrMSrzJJWiQ

端上传文件或者上传文件夹，HTML+AJAX实现上传大文件方案，h5批量下载文件，HTTP+断点续传，前端处理大文件/视频分片上传，断点续传，VUE—实现文件上传（多文件），图片上传，VUE 项目大文件上传下载解决方案，VUE将前端的JSON文件上传到后台对应目录，

JAVASCRIPT之分片上传，断点续传的实际项目实现详解，大文件上传如何做断点续传?全端+后端结合开发，VUE实现文件上传(单文件、多文件、分片上传)，JS中实现文件上传下载的三种解决方案(推荐)，JS实现大文件上传——分片上传方法，完美解决WEB无法上传大文件方法，HTML大文件上传源码，

WEBUPLOAD组件实现文件上传功能和下载功能，js大文件上传下载解决方案，vue大文件上传下载解决方案

asp.net大文件上传下载解决方案，.net大文件上传下载解决方案，webform大文件上传下载解决方案，jsp大文件上传下载解决方案，java大文件上传下载解决方案，JAVASCRIPT 大文件上传下载切片解决方案，JAVASCRIPT 大文件上传下载切割解决方案，JAVASCRIPT 大文件上传下载分割解决方案，JAVASCRIPT 大文件上传下载分块解决方案，JAVASCRIPT 大文件上传下载分片解决方案，web大文件上传下载解决方案，

网页大文件上传下载解决方案，前端大文件上传下载解决方案，html5大文件上传下载解决方案，JAVASCRIPT 大文件上传下载解决方案，支持

之前在网上也找过相关的资料，论坛上也有网友交流过，但是基本上都不太令人满意，与公司这边的项目需求相差太远。文章的话基本上大部分都是重复的内容，几乎都是讲的如何用HTML5来做，但是提到的也不多。

HTML5,VUE2,VUE3,React，javascript等常用前端UI框架，JS框架，网上找的方案大多数都只是一些代码片段，没有提供完整的前后端代码。

原理到是不复杂。上传位置不能传错。用户主要强调稳定性和兼容性。

之前在网上也搜过相关的资料。论坛里面也有一些网络交流，但是都不太令人满意。公司这边实际上需要的是一成熟的商业解决方案，需要能够提供成功案例，公司客户都是国企。

跟项目经理沟通过，这块网上搜到的文章能用的几乎没有。实际上客户那边比较在乎两点。

之前项目上面用Flash比较多一点，现在基本上都是HTML5，断点续传除了页面级以外最好还能够提供离线支持。

支持IE，Chrome和信创国产化环境，比如银河麒麟，统信UOS，龙芯，

支持分片，分块，分段，切片，分割上传。能够突破chrome每域名的5个TCP连接限制，能够突破chrome重启，关闭浏览器续传的限制。

支持10G,20G,50G,100G文件上传和续传，支持秒传，支持文件夹上传，重复文件检测，重复文件校验

支持文件下载，批量下载，下载断点续传，加密下载，端到端加密，加密算法支持国密SM4，多线程下载

支持在服务端保存文件夹层级结构，支持将文件夹层级结构信息保存到数据库中，支持下载时能够将文件夹层级结构下载下来，支持下载文件夹，下载文件夹支持断点续传，

支持加密传输，包括加密上传，加密下载，加密算法支持国密SM4，

支持云对象存储，比如华为云，阿里云，腾讯云，七牛云，AWS，MinIO,FastDFS，

提供手机，QQ，微信，邮箱等联系方式，提供7*24小时技术支持，提供长期技术支持和维护服务，提供远程1对1技术指导，提供二次开发指导，提供文档教程，提供视频教程。

视频教程：

https://www.ixigua.com/7226245960341389859

1.下载示例

https://gitee.com/xproer/up6-vue-cli

将up6组件复制到项目中

示例中已经包含此目录

1.引入up6组件

2.配置接口地址

接口地址分别对应：文件初始化，文件数据上传，文件进度，文件上传完毕，文件删除，文件夹初始化，文件夹删除，文件列表

参考：http://www.ncmem.com/doc/view.aspx?id=e1f49f3e1d4742e19135e00bd41fa3de

3.处理事件

启动测试

启动成功

效果

数据库

源码工程文档：https://drive.weixin.qq.com/s?k=ACoAYgezAAw1dWofra

源码报价单：https://drive.weixin.qq.com/s?k=ACoAYgezAAwoiul8gl

OEM版报价单：https://drive.weixin.qq.com/s?k=ACoAYgezAAwuzp4W0a

控件源码下载：https://drive.weixin.qq.com/s?k=ACoAYgezAAwbdKCskc
授权码生成器：https://drive.weixin.qq.com/s?k=ACoAYgezAAwTIcFph1

在线咨询

上一篇：多彩高原来古村
下一篇：22个宁静优雅的蓝色系网页设计

您的项目需求

*请认真填写需求信息，我们会在24小时内与您取得联系。

整合营销服务商