SpringMVC之文件的上传

最新推荐文章于 2024-05-23 16:55:24 发布

键盘敲烂~~~

最新推荐文章于 2024-05-23 16:55:24 发布

阅读量1.7k

点赞数 25

分类专栏： SpringMVC 文章标签： java java-ee mvc springmvc 文件上传

本文链接：https://blog.csdn.net/liubopro666/article/details/135152503

版权

SpringMVC 专栏收录该内容

9 篇文章 0 订阅

订阅专栏

系列文章目录

提示：这里可以添加系列文章的所有文章的目录，目录需要自己手动添加
SpringMVC之文件的上传

提示：写完文章后，目录可以自动生成，如何生成可参考右边的帮助文档

前言

提示：这里可以添加本文要记录的大概内容：

在当今数字化的时代，文件上传已经成为了许多应用程序中常见的功能之一。无论是在社交媒体、电子商务还是企业内部的文件管理系统中，用户都需要能够方便地上传文件。而作为一款优秀的 Java Web 框架，Spring MVC 为开发者提供了一种简单而强大的方式来实现文件上传功能。
通过 Spring MVC，开发者可以轻松地接收用户上传的文件，并将其保存到指定的位置。同时，Spring MVC 还提供了丰富的注解和拦截器，使得开发者可以更方便地处理文件上传的逻辑，以及对上传的文件进行校验和过滤。
在本博客中，我们将深入探讨 Spring MVC 中文件上传的相关概念和技术。我们将从基础知识开始，逐步介绍如何创建文件上传表单、处理上传请求以及保存上传的文件。此外，我们还将讨论一些高级主题，如文件类型校验、文件大小限制以及文件上传的安全性等。
无论你是 Spring MVC 的新手，还是有一定经验的开发者，本博客都将为你提供有价值的信息和实用的技巧。让我们一起开启 Spring MVC 文件上传的探索之旅吧！

提示：以下是本篇文章正文内容，下面案例可供参考

一、文件上传

原生方式上传

1.前端页面添加表单，设置enctype属性为multipart/form-data，并添加一个元素用于选择文件，以及一个提交按钮。

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
  <head>
    <title>上传</title>
  </head>
  <body>
    <h3>文件上传</h3>
     <%-- 表单的提交方式必须是post --%>
     <%-- enctype属性为multipart/form-data，意思是不对表单数据进行编码 --%>
    <form action="/fileUpload" method="post" enctype="multipart/form-data">
       <%-- 文件选择控件,类型是file，必须要有name属性--%>
       选择文件：<input type="file" name="upload"/>
      <input type="submit" value="上传"/>
    </form>
  </body>
</html>

2.引入依赖

<!-- 文件上传 -->
<dependency>
  <groupId>commons-fileupload</groupId>
  <artifactId>commons-fileupload</artifactId>
  <version>1.3.1</version>
</dependency>
<dependency>
  <groupId>commons-io</groupId>
  <artifactId>commons-io</artifactId>
  <version>2.4</version>
</dependency>

3.接收请求体数据，并写入磁盘

@RequestMapping("/fileUpload")
public String upload(HttpServletRequest request) throws Exception {
  // 创建文件夹，存放上传文件
  // 1.设置上传文件夹的真实路径
  String realPath = request.getSession().getServletContext().getRealPath("/upload");
  // 2.判断该目录是否存在，如果不存在，创建该目录
  File file = new File(realPath);
  if(!file.exists()){
    file.mkdirs();
   }
  // 分析请求体，找到上传文件数据
  // 1.创建磁盘文件工厂
  DiskFileItemFactory factory = new DiskFileItemFactory();
  // 2.创建上传数据分析器对象
  ServletFileUpload servletFileUpload = new ServletFileUpload(factory);
  // 3.利用分析器对象解析请求体，返回所有数据项
  List<FileItem> fileItems = servletFileUpload.parseRequest(request);
  // 4.遍历所有数据，找到文件项（非表单项）
  for (FileItem fileItem:fileItems){
    if(!fileItem.isFormField()){
      // 将文件数据写入文件夹
      // 1.获取文件名
      String name = fileItem.getName();
      // 2.将文件写入磁盘
      fileItem.write(new File(file,name));
      // 3.删除内存中的临时文件
      fileItem.delete();
     }
   }
  return "index";
}

SpringMVC方式上传

SpringMVC文件解析器对象，可以直接将请求体中的文件数据转为MuiltipartFile对象
1.在SpringMVC核心配置文件配置文件解析器

<!-- 文件解析器对象，id名称必须是multipartResolver -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
  <!-- 支持一次上传文件的总容量。单位：字节 100M = 100*1024*1024-->
  <property name="maxUploadSize" value="104857600"/>
  <!-- 文件名的编码方式-->
  <property name="defaultEncoding" value="utf-8"/>
</bean>

2.前端文件上传代码

<!DOCTYPE html>
<html>
<head>
    <title>File Upload Example</title>
</head>
<body>
    <h1>文件上传</h1>
    <form action="/upload" method="post" enctype="multipart/form-data">
        <input type="file" name="file" />
        <input type="submit" value="上传" />
    </form>
</body>
</html>

3.后端代码实现文件上传
注：记得引入前面的依赖

// MultipartFile参数名必须和HTML文件空间的name属性一致
@RequestMapping("/upload")
public String upload(MultipartFile file,HttpServletRequest request) throws IOException {
  // 创建文件夹，存放上传文件
  String realPath = request.getSession().getServletContext().getRealPath("/upload");//获取当前 Web 应用的实际路径下的 /upload 文件夹的路径。
  File dir = new File(realPath);
  if(!dir.exists()){
    dir.mkdirs();
   }
  // 将上传的数据写到文件夹的文件中
  // 1.拿到上传的文件名
  String filename = file.getOriginalFilename();
  filename = UUID.randomUUID()+"_"+filename;
  // 2.创建空文件
  File newFile = new File(dir,filename);
  // 3.将数据写入空文件中
  file.transferTo(newFile);
  return "index";
}

注意注意：
MultipartFile参数名必须和HTML文件空间的name属性一致
MultipartFile参数名必须和HTML文件空间的name属性一致
MultipartFile参数名必须和HTML文件空间的name属性一致
重要的事情说3遍
此外，还需要注意文件上传的大小限制、文件路径的安全性等方面的问题，以确保文件上传功能的可靠性和安全性。

多文件上传

1.在SpringMVC核心配置文件配置文件解析器

<!-- 文件解析器对象，id名称必须是multipartResolver -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
  <!-- 支持一次上传文件的总容量。单位：字节 100M = 100*1024*1024-->
  <property name="maxUploadSize" value="104857600"/>
  <!-- 文件名的编码方式-->
  <property name="defaultEncoding" value="utf-8"/>
</bean>

2.前端文件上传代码

<!DOCTYPE html>
<html>
<head>
    <title>文件上传</title>
</head>
<body>
    <h1>文件上传</h1>

    <!-- 文件上传表单 -->
    <form action="/upload" method="post" enctype="multipart/form-data">
        <input type="file" name="file" multiple>
         <input type="file" name="file" multiple>
        <input type="submit" value="上传">
    </form>
</body>
</html>

3.后端代码实现
注：记得引入前面的依赖

 // 上传多个文件的处理方法
    @RequestMapping(value = "/uploadMultiple", method = RequestMethod.POST)
    public String handleUploadMultipleFiles(@RequestParam("file") List<MultipartFile> files) {
        // 创建一个 List 来存储上传的文件名
        List<String> fileNames = new ArrayList<>();
        if (files != null) {
            for (MultipartFile file : files) {
                // 获取上传的文件名
                String fileName = file.getOriginalFilename();
                // 在本地创建文件
                File localFile = new File(fileName);
                // 将上传的文件内容写入本地文件
                try {
                    file.transferTo(localFile);
                    System.out.println("文件 " + fileName + " 上传成功！");
                    fileNames.add(fileName);
                } catch (Exception e) {
                    System.out.println("文件上传失败！");
                }
            }
        }
        // 输出上传的文件名列表
        System.out.println("上传的文件名列表：" + fileNames);
        return "上传成功";
    }

多文件上传和单文件上传相传不大，只是参数不一样，任可参考单文件上传

异步上传

什么是异步上传

HTTP 异步上传是一种在 Web 应用程序中常见的场景，它允许用户上传文件到服务器而无需等待整个上传过程完成。以下是一个通俗易懂的解释：
想象一下，你有一个网站，用户可以在该网站上上传他们的照片或其他文件。当用户选择要上传的文件并点击“上传”按钮时，传统的上传方式会立即将文件发送到服务器，并在上传完成之前阻止用户进行其他操作。
但是，在异步上传的场景中，事情会有所不同。当用户点击“上传”按钮时，你的网站会将文件的一部分数据发送到服务器，并立即向用户显示一个进度条或其他反馈，让他们知道上传正在进行中。然后，用户可以继续在网站上进行其他操作，而上传将在后台继续进行。
在后台，上传进程会将文件的剩余部分逐渐发送到服务器，而不会阻塞用户的操作。这意味着用户可以在上传进行的同时浏览其他页面、填写表单或执行其他任务。当上传完成时，服务器会通知用户，并可以在网站上显示上传成功的消息。
这种异步上传的方式可以提供更好的用户体验，因为用户无需等待整个上传过程完成，他们可以继续与网站进行交互，而上传将在后台自动进行。

实现步骤

1.前端文件上传代码，引入jQuery和jQuery表单上传工具jquery.form.js

<!DOCTYPE html>
<html>
<head>
    <title>文件上传</title>
</head>
<body>
    <h1>文件上传</h1>

    <!-- 文件上传表单 -->
    <form action="/upload" method="post" enctype="multipart/form-data" id="a">
        <input type="file" name="file" multiple>
         <input type="file" name="file" multiple>
        <input type="button" value="上传" id="btn">
    </form>
    <script>
  $(function () {
    $("#btn").click(function () {
      // 异步提交表单
      $("#a").ajaxSubmit({
        url:"/fileUpload4",
        type:"post",
        success:function (data) {
          $("#img").attr("src",data);
         }
       })
     })
   })
</script>
</body>
</html>

2.后端代码

@RequestMapping("/fileUpload4")
//不进行页面跳转
@ResponseBody
public String upload3(HttpServletRequest request, MultipartFile file) throws Exception {
  // 创建文件夹，存放上传文件。
  String realPath = request.getSession().getServletContext().getRealPath("/upload");
  File dir = new File(realPath);
  if (!dir.exists()){
    dir.mkdirs();
   }
  // 拿到上传文件名
  String filename = file.getOriginalFilename();
  filename = UUID.randomUUID()+"_"+filename;
  // 创建空文件
  File newFile = new File(dir, filename);
  // 将上传的文件写到空文件中
  file.transferTo(newFile);
  // 返回文件的路径
  return "/upload/"+filename;
}

跨服务器上传

由于文件占据磁盘空间较大，在实际开发中往往会将文件上传到其他服务器中，此时需要使用跨服务器上传文件。假设现在我们有两台服务器，一台服务器是上传文件的服务器，端口是8080，另一台是图片服务器，用于储存用户上传的文件，端口9090
1.修改tomcat的conf/web.xml文件，支持跨服上传

<servlet>  
  <init-param>    
    <param-name>readonly</param-name>   
    <param-value>false</param-value>  
  </init-param>
</servlet>

2.编写前端代码，用异步提交方式提交，这里参考前面的代码，不予展示
3.添加跨服上传依赖

<!-- 跨服上传 -->
<dependency>
  <groupId>com.sun.jersey</groupId>
  <artifactId>jersey-core</artifactId>
  <version>1.18.1</version>
</dependency>
<dependency>
  <groupId>com.sun.jersey</groupId>
  <artifactId>jersey-client</artifactId>
  <version>1.18.1</version>
</dependency>

4.后端代码实现

@RequestMapping("/fileUpload5")
@ResponseBody
public String upload4(HttpServletRequest request, MultipartFile file) throws Exception {
  // 设置跨服上传的服务器路径
  String path = "http://localhost:9090/upload/";
  // 获取上传的文件名
  String filename = file.getOriginalFilename();
  filename = UUID.randomUUID()+"_"+filename;
  // 跨服上传：
  // 1.创建客户端对象
  Client client = Client.create();
  // 2.使用客户端对象连接图片服务器
  WebResource resource = client.resource(path + filename);
  //3.传输数据
  resource.put(file.getBytes());
  return path+filename;
}

总结

提示：这里对文章进行总结：

总的来说，Spring MVC 为文件上传提供了一套简洁而强大的解决方案。通过本博客的学习，你应该对 Spring MVC 文件上传有了更深入的理解，并能够在实际项目中应用这些知识。希望本博客对你有所帮助，如有任何问题，欢迎留言讨论！

键盘敲烂~~~

关注

25
点赞
踩
27

收藏

觉得还不错? 一键收藏
0
评论
SpringMVC之文件的上传

在当今数字化的时代，文件上传已经成为了许多应用程序中常见的功能之一。无论是在社交媒体、电子商务还是企业内部的文件管理系统中，用户都需要能够方便地上传文件。而作为一款优秀的 Java Web 框架，Spring MVC 为开发者提供了一种简单而强大的方式来实现文件上传功能。通过 Spring MVC，开发者可以轻松地接收用户上传的文件，并将其保存到指定的位置。同时，Spring MVC 还提供了丰富的注解和拦截器，使得开发者可以更方便地处理文件上传的逻辑，以及对上传的文件进行校验和过滤。
复制链接

扫一扫