目录:

作者简介 :一只大皮卡丘,计算机专业学生,正在努力学习、努力敲代码中! 让我们一起继续努力学习!
该文章参考学习教材为:
《Spring Boot企业级开发教程》 黑马程序员 / 编著
文章以课本知识点 + 代码为主线,结合自己看书学习过程中的理解和感悟 ,最终成就了该文章文章用于本人学习使用 , 同时希望能帮助大家。
欢迎大家点赞👍 收藏⭐ 关注💖哦!!!(侵权可联系我,进行删除,如果雷同,纯属巧合)
一、SpringBoot中进行 " 文件上传" :
- 开发Wb应用时,文件上传是很常见的一个需求,浏览器 通过 表单形式 将 文件 以 流的形式传递 给 服务器,服务器再对上传的数据解析处理。下面将通过一个案例讲解使用 SpringBoot 实现 文件上传,具体步骤 如下 :
1.编写 “文件上传” 的 “表单页面”
- 在项目的 templates模板引擎文件夹下创建一个用来上传文件的upload.html模板页面 :
- upload.html :
<!DOCTYPEhtml><htmllang="en"xmlns:th="http://www.thymeleaf.org"><head><metacharset="UTF-8"><metahttp-equiv="Content-Type"content="text/html; charset=UTF-8"><title>动态添加文件上传列表</title><linkth:href="@{/login/css/bootstrap.min.css}"rel="stylesheet"><scriptth:src="@{/login/js/jquery-3.7.1.min.js}"></script></head><body><divth:if="${uploadStatus}"style="color: red"th:text="${uploadStatus}"> 上传成功</div><formth:action="@{/uploadFile}"method="post"enctype="multipart/form-data"> 上传文件: <inputtype="button"value="添加文件"onclick="add()"/><divid="file"style="margin-top: 10px;"th:value="文件上传区域"></div><inputid="submit"type="submit"value="上传"style="display: none;margin-top: 10px;"/></form><scripttype="text/javascript">functionadd(){var innerdiv ="<div>"; innerdiv +="<input type='file' name='fileUpload' required='required'>"+"<input type='button' value='删除' οnclick='remove(this)'>"; innerdiv +="</div>";$("#file").append(innerdiv);$("#submit").css("display","block");}functionremove(obj){$(obj).parent().remove();if($("#file div").length ==0){$("#submit").css("display","none");}}</script></body></html>
2.在全局配置文件中添加文件上传的相关配置
- 在 全局配置文件 : application.properties中添加文件上传的相关设置,配置如下 :application.properties :
spring.application.name=chapter_12#thymeleaf的页面缓存设置(默认为true),开发中为方便调试应设置为false,上线稳定后应保持默认truespring.thymeleaf.cache=false##配置国际化文件基础名#spring.messages.basename=i18n.login#单个文件上传大小限制(默认为1MB)spring.servlet.multipart.max-file-size=10MB#总文件上传大小限制spring.servlet.multipart.max-request-size=50MB在 application.properties****全局配置文件中,对文件 上传过程中的上传大小进行了设置。
3.进行文件上传处理,实现 “文件上传” 功能
- FileController.java :
packagecom.myh.chapter_12.controller;importorg.springframework.boot.Banner;importorg.springframework.stereotype.Controller;importorg.springframework.ui.Model;importorg.springframework.web.bind.annotation.GetMapping;importorg.springframework.web.bind.annotation.PostMapping;importorg.springframework.web.multipart.MultipartFile;importjava.io.File;importjava.io.IOException;importjava.util.UUID;/** * 文件管理控制类 */@Controller//加入到IOC容器中publicclassFileController{//关于File的controller类@GetMapping("/toUpload")publicStringtoUpload(){return"upload";}@PostMapping("/uploadFile")publicStringuploadFile(MultipartFile[] fileUpload,Model model){//默认文件上传成功,并返回状态信息 model.addAttribute("uploadStatus","上传成功!");for(MultipartFile file : fileUpload){//获取文件名以及后缀名 (获取原始文件名)String fileName = file.getOriginalFilename();//使用UUID + 原始文件名 来生成一个新的文件名 fileName =UUID.randomUUID()+"_"+fileName;//指定文件上传的本地存储目录,不存在则提前创建String dirPath ="S:\\File\\";File filePath =newFile(dirPath);if(!filePath.exists()){filePath.mkdirs();}//创建该目录try{//执行“文件上传”的方法 file.transferTo(newFile(dirPath+fileName));}catch(Exception e){e.printStackTrace();//上传失败,返回失败信息 model.addAttribute("uploadStatus","上传失败: "+e.getMessage());}}//携带状态信息回调到文件上传页面return"upload";}}
4.效果测试
- 启动项目,在浏览器访问****http://localhost:8080/toUpload ,效果如下图所示 :
---
---
通过以上图片可以看出,SpringBoot 中进行 “文件上传”成功 。
二、SpringBoot中进行 “文件下载” :
- 下载文件能够通过IO流实现,所以 多数框架并没有对文件下载进行封装处理。文件下载时涉及不同浏览器的解析处理,可能会出现 中文乱码 的情况。 接下来将针对 下载英文名文件 和 中文名文件 进行讲解。
“英文名称” 文件下载 :
1.添加文件下载工具依赖
- 在 pom.xml文件中引入文件下载的一个工具依赖 :
<!-- 文件下载的工具依赖 --><dependency><groupId>commons-io</groupId><artifactId>commons-io</artifactId><version>2.6</version></dependency>
2.定制文件下载页面
- download.html :
<!DOCTYPEhtml><htmllang="en"xmlns:th="http://www.thymeleaf.org"><head><metacharset="UTF-8"><title>"英文名称"文件下载</title></head><body><divstyle="margin-bottom: 10px">文件下载列表:</div><table><tr><td>嘻嘻哈哈123.txt</td><td><ath:href="@{/download(filename='5afa8ee7-6cbf-4632-9965-4df31aad4558_嘻嘻哈哈123456.txt')}">下载该文件</a></td></tr><tr><td>嘻嘻哈哈123456.txt</td><td><ath:href="@{/download(filename='c53a27b1-b42e-41a4-b283-86ac43034203_嘻嘻哈哈123.txt')}">下载该文件</a></td></tr></table></body></html>上面代码中通过列表展示了要下载的两个 文件名及其下载链接。需要注意的是,在文件下载之前,需要保证在文件下载目录(本示例中的“S:\File”目录)中存在对应的文件,可以自行存放,只要 保持文件名统一 即可。
3.编写文件下载处理方法
- FileController.java :
packagecom.myh.chapter_12.controller;importjakarta.servlet.http.HttpServletRequest;importorg.apache.commons.io.FileUtils;importorg.springframework.boot.Banner;importorg.springframework.http.HttpHeaders;importorg.springframework.http.HttpStatus;importorg.springframework.http.MediaType;importorg.springframework.http.ResponseEntity;importorg.springframework.stereotype.Controller;importorg.springframework.ui.Model;importorg.springframework.web.bind.annotation.GetMapping;importorg.springframework.web.bind.annotation.PostMapping;importorg.springframework.web.multipart.MultipartFile;importjava.io.File;importjava.io.IOException;importjava.net.URLEncoder;importjava.util.UUID;/** * 文件管理控制类 */@Controller//加入到IOC容器中publicclassFileController{//关于File的controller类@GetMapping("/toDownload")publicStringtoDownload(){return"download";}/** * 英文名称文件下载 */@GetMapping("/download")publicResponseEntity<byte[]>fileDownload(String filename){//指定要下载的文件根路径String dirPath ="S:\\File\\";//创建该文件对象File file =newFile(dirPath +File.separator + filename);//设置响应头HttpHeaders headers =newHttpHeaders();//通知浏览器以下载方式打开 headers.setContentDispositionFormData("attachment",filename);//定义以流的形式下载返回文件数据 headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);try{returnnewResponseEntity<>(FileUtils.readFileToByteArray(file), headers,HttpStatus.OK);}catch(Exception e){e.printStackTrace();returnnewResponseEntity<byte[]>(e.getMessage().getBytes(),HttpStatus.EXPECTATION_FAILED);}}}
4.效果测试
- 启动项目,在浏览器访问****http://localhost:8080/toDownload ,效果如下图所示 :
---
“中文名称” 文件下载 :
1.添加文件下载工具依赖
- 在 pom.xml文件中引入文件下载的一个工具依赖 :
<!-- 文件下载的工具依赖 --><dependency><groupId>commons-io</groupId><artifactId>commons-io</artifactId><version>2.6</version></dependency>
2.定制文件下载页面
- download.html :
<!DOCTYPEhtml><htmllang="en"xmlns:th="http://www.thymeleaf.org"><head><metacharset="UTF-8"><title>中文名称文件下载</title></head><body><divstyle="margin-bottom: 10px">文件下载列表:</div><table><tr><td>嘻嘻哈哈123456.txt</td><td><ath:href="@{/download(filename='708ebc14-2ca7-4b66-b0bf-3b9c65df6ec1_嘻嘻哈哈123456.txt')}">下载该文件</a></td></tr><tr><td>嘻嘻哈哈123.txt</td><td><ath:href="@{/download(filename='418b0e77-59dc-4697-8a62-6a450d466567_嘻嘻哈哈123.txt')}">下载该文件</a></td></tr></table></body></html>上面代码中通过列表展示了要下载的两个 文件名及其下载链接。需要注意的是,在文件下载之前,需要保证在文件下载目录(本示例中的“S:\File”目录)中存在对应的文件,可以自行存放,只要 保持文件名统一 即可。
3.编写文件下载处理方法
- FileController.java :
packagecom.myh.chapter_12.controller;importjakarta.servlet.http.HttpServletRequest;importorg.apache.commons.io.FileUtils;importorg.springframework.boot.Banner;importorg.springframework.http.HttpHeaders;importorg.springframework.http.HttpStatus;importorg.springframework.http.MediaType;importorg.springframework.http.ResponseEntity;importorg.springframework.stereotype.Controller;importorg.springframework.ui.Model;importorg.springframework.web.bind.annotation.GetMapping;importorg.springframework.web.bind.annotation.PostMapping;importorg.springframework.web.multipart.MultipartFile;importjava.io.File;importjava.io.IOException;importjava.net.URLEncoder;importjava.util.UUID;/** * 文件管理控制类 */@Controller//加入到IOC容器中publicclassFileController{//关于File的controller类@GetMapping("/toDownload")publicStringtoDownload(){return"download";}/** * "中文名称"文件下载 */@GetMapping("/download")publicResponseEntity<byte[]>fileDownload(HttpServletRequest request,String filename)throwsException{//指定下载的文件根路径String dirPath ="S:\\File\\";//创建该文件对象File file =newFile(dirPath +File.separator + filename);//设置响应头HttpHeaders headers =newHttpHeaders();//通知浏览器以下载方式打开(下载前对文件名进行转码) filename=getFilename(request,filename); headers.setContentDispositionFormData("attachment",filename);//定义以流的形式下载返回文件数据 headers.setContentType(MediaType.APPLICATION_OCTET_STREAM);try{returnnewResponseEntity<>(FileUtils.readFileToByteArray(file), headers,HttpStatus.OK);}catch(Exception e){e.printStackTrace();returnnewResponseEntity<byte[]>(e.getMessage().getBytes(),HttpStatus.EXPECTATION_FAILED);}}//根据浏览器的不同进行编码设置,返回编码后的文件名privateStringgetFilename(HttpServletRequest request,String filename)throwsException{//IE不同版本User-Agent中出现的关键词String[]IEBrowserKeyWords={"MSIE","Trident","Edge"};//获取请求头代理信息String userAgent = request.getHeader("User-Agent");for(String keyWord :IEBrowserKeyWords){if(userAgent.contains(keyWord)){//IE内核浏览器,统一为UTF-8编码显示,并对转换的+进行更正returnURLEncoder.encode(filename,"UTF-8").replace("+"," ");}}//火狐等其他浏览器统一为ISO-8859-1编码显示returnnewString(filename.getBytes("UTF-8"),"ISO-8859-1");}}
4.效果测试
- 启动项目,在浏览器访问****http://localhost:8080/toDownload ,效果如下图所示 :
---
版权归原作者 一只大皮卡丘 所有, 如有侵权,请联系我们删除。
---
---
通过以上图片可以看出,SpringBoot 中进行 “文件上传”成功 。
---
---