一、概述
( 1 ) 介绍
Spring MVC的文件上传下载是指在Spring MVC框架中实现文件的上传和下载功能。文件上传是指将本地计算机上的文件上传到服务器端，而文件下载是指从服务器端将文件下载到本地计算机上。
Spring MVC提供了方便的机制来处理文件上传和下载。文件上传可以通过配置MultipartResolver Bean来处理上传请求，并使用@RequestParam注解来接收上传的文件。然后可以将文件保存到指定位置。
文件下载可以通过在Controller中返回ResponseEntity<byte[]>对象来表示要下载的文件。可以设置响应头信息，包括Content-Disposition和Content-Type，并将文件内容读取到字节数组中，最后将字节数组写入响应流中，完成文件下载。
文件上传下载在实际开发中非常常见，例如用户上传头像、上传文件等场景都需要使用文件上传功能。而文件下载可以用于提供用户下载文件、下载导出的报表等场景。
Spring MVC的文件上传下载功能可以方便地与其他Spring MVC特性结合使用，例如数据绑定、表单验证等，从而实现更复杂的业务需求。同时，Spring MVC还提供了一些工具类和注解来简化文件上传下载的操作，使开发更加便捷。
( 2 ) 讲述
使用Spring MVC进行文件上传和下载需要以下步骤：
文件上传：
- 1. 首先，在Spring MVC的配置文件中配置MultipartResolver Bean。可以使用CommonsMultipartResolver或者StandardServletMultipartResolver。
- 2. 在Controller中，创建一个方法来处理文件上传请求。可以使用@RequestParam注解来接收上传的文件。例如，可以使用MultipartFile类型的参数来接收上传的文件。
- 3. 在方法中，可以使用MultipartFile对象的transferTo()方法将文件保存到指定的位置。可以使用File对象或者路径字符串作为参数。
文件下载：
- 1. 配置MultipartResolver Bean： 在Spring MVC的配置文件中，需要配置一个MultipartResolver Bean来处理文件上传请求。可以使用CommonsMultipartResolver或者StandardServletMultipartResolver。这两个Resolver都是Spring MVC提供的默认实现，可以根据项目需求选择其中一个。
- 2. 创建文件上传表单： 在前端页面中，创建一个表单用于文件上传。设置表单的enctype属性为"multipart/form-data"，以支持文件上传。
- 3. 创建Controller方法： 在Controller中，创建一个方法来处理文件上传请求。可以使用@RequestParam注解来接收上传的文件。例如，可以使用MultipartFile类型的参数来接收上传的文件。
- 4. 处理文件上传结果： 根据具体需求，可以在文件上传成功或失败后，返回不同的视图或进行其他操作。
以上是使用Spring MVC进行文件上传的基本步骤。需要注意的是，文件上传的大小限制、文件类型限制等可以通过配置MultipartResolver Bean来进行设置。此外，还可以使用其他第三方库来实现更复杂的文件上传功能，例如Apache Commons FileUpload。
需要注意的是，文件上传和下载的功能可以根据具体的需求进行调整和扩展。可以通过其他第三方库来实现更复杂的文件上传和下载操作，例如Apache Commons FileUpload和Apache HttpClient等。
另外，还可以使用Spring MVC提供的其他功能来增强文件上传下载的功能，例如数据校验、异常处理等。这样可以更好地满足实际项目的需求。
二、上传
以下实例演示的代码是基于本人博客中的代码进行扩展 : SpringMVC的整合完成CRUD
首先我们需要在数据库中的数据表( 酒店表[ t_hotel ] )进行增加一个字段来存放图片路径
我这里的属性名为 himage 数据表的字段如图 :
将自动生成的mapper和model包删除，进行重新生成接口，实体及配置文件，将我们新增的
字段进行自动增加进来，并且重新写模糊查询的配置动态SQL。
写在自动生成的HotelMapper.xml配置文件中
<select id="selectHotelPage" resultType="com.CloudJun.model.Hotel" parameterType="com.CloudJun.model.Hotel" > select * from t_hotel <where> <if test="hname != null"> and hname like concat('%',#{hname},'%') </if> </where> </select>
在自动生成的接口 HotelMapper 中增加以下代码
List<Hotel> selectHotelPage(Hotel hotel);
创建一个公共路径处理类 名为 : PageController
package com.CloudJun.web; import org.springframework.stereotype.Controller; import org.springframework.web.bind.annotation.PathVariable; import org.springframework.web.bind.annotation.RequestMapping; /** * @author CloudJun * @create 2023-09-07 14:39 */ @Controller public class PageController { @RequestMapping("/page/{page}") public String to(@PathVariable("page") String page){ return page; } @RequestMapping("/page/{dir}/{page}") public String to(@PathVariable("dir") String dir, @PathVariable("page") String page){ return dir+"/"+page; } }
将前端的 index.jsp 代码所以修改为以下代码
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib uri="http://jsp.veryedu.cn" prefix="z"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <link href="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/4.5.0/css/bootstrap.css" rel="stylesheet"> <script src="https://cdn.bootcdn.net/ajax/libs/twitter-bootstrap/4.5.0/js/bootstrap.js"></script> <title>酒店后台管理系统</title> <style type="text/css"> .page-item input { padding: 0; width: 40px; height: 100%; text-align: center; margin: 0 6px; } .page-item input, .page-item b { line-height: 38px; float: left; font-weight: 400; } .page-item.go-input { margin: 0 10px; } </style> </head> <body> <form class="form-inline" action="${pageContext.request.contextPath }/hot/list" method="post"> <div class="form-group mb-2"> <input type="text" class="form-control-plaintext" name="hname" placeholder="请输入书籍名称"> <%-- <input name="rows" value="10" type="hidden">--%> <!-- 不想分页 --> <%-- <input name="pagination" value="false" type="hidden">--%> </div> <button type="submit" class="btn btn-primary mb-2">查询</button> <a class="btn btn-primary mb-2" href="${pageContext.request.contextPath }/hot/revise">新增</a> </form> <table class="table table-striped"> <thead> <tr> <th scope="col">房间编号</th> <th scope="col">房间名称</th> <th scope="col">房间类型</th> <th scope="col">房间图片</th> <th scope="col">操作</th> </tr> </thead> <tbody> <c:forEach var="h" items="${list }"> <tr> <td>${h.hid }</td> <td>${h.hname }</td> <td> <img src="${h.himage }"style="height: 100px;width: 100px;"> </td> <td>${h.htype }</td> <td> <a href="${pageContext.request.contextPath }/hot/revise?hid=${h.hid}">修改</a> <a href="${pageContext.request.contextPath }/hot/del?hid=${h.hid}">删除</a> <a href="${pageContext.request.contextPath }/page/hot/upload?hid=${h.hid}">图片上传</a> <a href="${pageContext.request.contextPath }/hot/download?hid=${h.hid}">图片下载</a> </td> </tr> </c:forEach> </tbody> </table> <!-- 这一行代码就相当于前面分页需求前端的几十行了 --> <z:page pageBean="${pageBean }"></z:page> </body> </html>
在 HotelController 控制器中增加文件上传的方法路径进行配置
//文件上传 @RequestMapping("/upload") public String uploadFile(Hotel hotel,MultipartFile multipartFile) throws Exception { //文件上传的本地存放地址 String dir= PropertiesUtil.getValue("dir"); //网络访问地址(请求) String server = PropertiesUtil.getValue("server"); String filename = multipartFile.getOriginalFilename(); FileUtils.copyInputStreamToFile(multipartFile.getInputStream(),new File(dir+filename)); hotel.setHimage(server+filename); hotelbiz.updateByPrimaryKeySelective(hotel); return "redirect:list"; }
创建一个名为 upload.jsp 的页面进行显示操作
<%@ page contentType="text/html;charset=UTF-8" language="java" %> <html> <head> <title>Title</title> </head> <body> <form action="${pageContext.request.contextPath }/hot/upload" method="post" enctype="multipart/form-data"> <label>班级编号：</label><input type="text" name="hid" readonly="readonly" value="${param.hid}"/><br/> <label>班级图片：</label><input type="file" name="multipartFile"/><br/> <input type="submit" value="上传图片"/> </form> <form method="post" action="${pageContext.request.contextPath }/hot/uploads" enctype="multipart/form-data"> <input type="file" name="files" multiple> <button type="submit">上传</button> </form> </body> </html>
创建一个名为 resource.properties 的资源文件
dir=D:/temp/upload/ server=/upload/
创建工具类 PropertiesUtil
package com.CloudJun.utils; import java.io.IOException; import java.io.InputStream; import java.util.Properties; public class PropertiesUtil { public static String getValue(String key) throws IOException { Properties p = new Properties(); InputStream in = PropertiesUtil.class.getResourceAsStream("/resource.properties"); p.load(in); return p.getProperty(key); } }
然后启动服务器，访问浏览器路径 ( 根据自己的配置及控制器进行填入访问路径 )
访问该路径进行测试 : http://localhost:8080/ssm/hot/list
结果如下 ：
三、下载
需要在 HotelController 控制器中增加文件下载的方法路径进行配置
//文件下载 @RequestMapping("/download") public ResponseEntity<byte[]> download(Hotel hotel, HttpServletRequest req){ try { //先根据文件id查询对应图片信息 Hotel hot = hotelbiz.selectByPrimaryKey(hotel.getHid()); String diskPath = PropertiesUtil.getValue("dir"); String reqPath = PropertiesUtil.getValue("server"); String realPath = hot.getHimage().replace(reqPath,diskPath); String fileName = realPath.substring(realPath.lastIndexOf("/")+1); //下载关键代码 File file=new File(realPath); HttpHeaders headers = new HttpHeaders();//http头信息 String downloadFileName = new String(fileName.getBytes("UTF-8"),"iso-8859-1");//设置编码 headers.setContentDispositionFormData("attachment", downloadFileName); headers.setContentType(MediaType.APPLICATION_OCTET_STREAM); //MediaType:互联网媒介类型 contentType：具体请求中的媒体类型信息 return new ResponseEntity<byte[]>(FileUtils.readFileToByteArray(file),headers, HttpStatus.OK); }catch (Exception e){ e.printStackTrace(); } return null; }
之后可以直接开启服务器，在浏览器中进行测试
结果如下 :
四、jrebel的使用
根据图中操作，安装jrebel插件
然后下载该文件，进行jrebel的使用 : jrebel插件的辅助使用
如果觉得下载或者使用插件麻烦，也可以使用idea的自带Debug
(也可以进行项目启动，只是比较影响开发效率)
重新开启idea时会有如图上两个图标，已是启动服务器的图标(这是jrebel的使用)
打开下载的辅助插件的使用，会有一个黑窗口，有黑窗口后才可以进行jrebel那个两图标使用
之后会出现以下窗口，第一行输入 : http://127.0.0.1:8888/0e63ac70-2074-46d3-9de1-46fb2befde0a
第二行之后的操作如图 :
服务器成功启动后，在去设置里面进行离线模式的操作设置
此设置完是之后使用jrebel时可以不需要开启哪个辅助应用工具了(黑窗口)
JRebel是一个Java开发工具，它可以实现在不重启应用服务器的情况下，实时更新Java代码的功能。以下是JRebel插件的一些好处：
- 1. 提高开发效率：使用JRebel可以避免频繁的应用服务器重启，节省了开发人员的时间。每次修改Java代码后，只需要重新加载相关的类，即可立即看到代码变更的效果，无需重新启动整个应用。
- 2. 加快开发周期：应用服务器的启动通常需要一定的时间，而使用JRebel可以减少这个等待时间，从而加快了开发周期。开发人员可以更快地进行代码调试和测试，提高了开发效率。
- 3. 提供更好的调试体验：JRebel可以在不重启应用服务器的情况下，实时更新代码，从而提供了更好的调试体验。开发人员可以在调试过程中随时修改代码，查看变更的效果，快速定位和解决问题。
- 4. 支持多种框架和应用服务器：JRebel支持多种Java框架和应用服务器，包括Spring、Hibernate、Java EE等。无论是开发Web应用、企业应用还是移动应用，都可以使用JRebel进行实时代码更新。
- 5. 减少开发错误：由于JRebel可以实时更新代码，开发人员可以立即看到代码变更的效果，从而更容易发现和修复潜在的错误。这有助于提高代码质量和减少开发错误。
总的来说，JRebel插件可以提高Java开发的效率和质量，减少应用服务器重启的时间，提供更好的调试体验，从而加快开发周期。它是一个非常有用的工具，特别适合需要频繁修改和调试Java代码的开发人员。
五、多文件上传
需要在 HotelController 控制器中增加文件多文件上传的方法路径进行配置
//多文件上传 @RequestMapping("/uploads") public String uploads(HttpServletRequest req, Hotel hotel, MultipartFile[] files){ try { StringBuffer sb = new StringBuffer(); for (MultipartFile cfile : files) { //思路： //1) 将上传图片保存到服务器中的指定位置 String dir = PropertiesUtil.getValue("dir"); String server = PropertiesUtil.getValue("server"); String filename = cfile.getOriginalFilename(); FileUtils.copyInputStreamToFile(cfile.getInputStream(),new File(dir+filename)); sb.append(filename).append(","); } System.out.println(sb.toString()); } catch (Exception e) { e.printStackTrace(); } return "redirect:list"; }
增加完后，开启服务器进行浏览器的测试即可
测试结果:
给我们带来什么收获
学习Spring MVC的文件上传下载可以给我们带来以下收获：
- 1. 实现文件上传和下载功能：学习Spring MVC的文件上传下载，可以掌握如何在Web应用中实现文件的上传和下载功能。这对于很多应用来说是必需的，比如用户上传头像、上传附件等。
- 2. 提高用户体验：通过文件上传下载功能，可以提高用户的体验。用户可以方便地上传和下载文件，无需通过其他繁琐的方式来实现。这可以增加用户对应用的满意度和使用度。
- 3. 增加应用的功能和价值：通过文件上传下载功能，可以为应用增加更多的功能和价值。比如，可以实现用户之间的文件共享、文件的备份和恢复等功能，从而提升应用的实用性和吸引力。
- 4. 拓展自己的技术能力：学习Spring MVC的文件上传下载，可以拓展自己的技术能力。这涉及到文件处理、网络通信、安全性等方面的知识，可以帮助我们更全面地理解和应用Web开发相关的技术。
- 5. 掌握常用的文件处理技术：学习Spring MVC的文件上传下载，可以掌握一些常用的文件处理技术。比如，文件的读写、文件的压缩和解压、文件的加密和解密等。这些技术在实际开发中经常会用到，可以提高我们的工作效率。
总的来说，学习Spring MVC的文件上传下载可以带来很多收获，包括实现文件上传下载功能、提高用户体验、增加应用的功能和价值、拓展自己的技术能力以及掌握常用的文件处理技术。这对于Web开发人员来说是非常有价值的。
