您现在的位置是：亿华云 > 应用开发

让我们捋一捋上传和下载

亿华云2025-10-03 02:18:42【应用开发】7人已围观

简介GitHub：https://github.com/nateshao/ssm/tree/master/111-springmvc-file-upload1. 文件上传文件上传概述“多数文件上传都是通过

GitHub：https://github.com/nateshao/ssm/tree/master/111-springmvc-file-upload

1. 文件上传

文件上传概述

“多数文件上传都是让们通过表单形式提交给后台服务器的，因此，捋捋要实现文件上传功能，上传就需要提供一个文件上传的和下表单，而该表单必须满足以下3个条件：

form表单的让们method属性设置为post; form表单的enctype属性设置为multipart/form-data; 提供< input type="file" name="filename" />的文件上传输入框。

文件上传表单示例如下

multiple属性是捋捋HTML5中新属性，可实现多文件上传

当form表单的上传enctype属性为multipart/form-data时，浏览器就会采用二进制流来处理表单数据，和下服务器端就会对文件上传的让们请求进行解析处理。Spring MVC通过MultipartResolver实现文件上传功能。捋捋MultipartResolver是上传一个接口对象，需要通过它的和下实现CommonsMultipartResolver来完成文件上传工作。

MultipartResolver配置示例如下:

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> 设置请求编码格式，让们必须与JSP中的捋捋pageEncoding属性一致，默认为ISO-8859-1 <property name="defaultEncoding" value="UTF-8" /> 设置允许上传文件的上传最大值（2M），单位为字节 <property name="maxUploadSize" value="2097152" /> ... </bean>

在前面的配置代码中，除配置了CommonsMultipartResolver类外，还通过< property>元素配置了编码格式以及允许上传文件的大小。通过< property>元素可以对文件解析器类CommonsMultipartResolver的香港云服务器如下属性进行配置：

maxUploadSize：上传文件最大长度(以字节为单位); maxInMemorySize：缓存中的最大尺寸; defaultEncoding：默认编码格式; resolveLazily：推迟文件解析，以便在Controller中捕获文件大小异常。

注意：因为MultipartResolver接口的实现类CommonsMultipartResolver内部是引用multipartResolver字符串获取该实现类对象并完成文件解析的，所以在配置CommonsMultipartResolver时必须指定该Bean的id为multipartResolver。

由于CommonsMultipartResolver是Spring MVC内部通过Apache Commons FileUpload技术实现的，所以Spirng MVC的文件上传还需要依赖Apache Commons FileUpload的组件，即需要导入支持文件上传的相关JAR包。

commons-fileupload-1.3.2.jarlcommons-io-2.5.jar

当完成页面表单和文件上传解析器的配置后，在Controller中编写文件上传的方法即可实现文件上传，其代码如下所示：

/** * 执行文件上传 * @param name * @param uploadfile * @param request * @return */ @RequestMapping("/fileUpload") public String handleFormUpload(@RequestParam("name") String name, @RequestParam("uploadfile") List<MultipartFile> uploadfile,//使用MultipartFile 绑定接收上传文件 HttpServletRequest request) { // 判断所上传文件是否存在 if (!uploadfile.isEmpty() && uploadfile.size() > 0) { //循环输出上传的文件 for (MultipartFile file : uploadfile) { // 获取上传文件的原始名称 String originalFilename = file.getOriginalFilename(); // 设置上传文件的保存地址目录 String dirPath = request.getServletContext().getRealPath("/upload/"); File filePath = new File(dirPath); // 如果保存文件的地址不存在，就先创建目录 if (!filePath.exists()) { filePath.mkdirs(); } // 使用UUID重新命名上传的文件名称(上传人_uuid_原始文件名称) String newFilename = name + "_" + UUID.randomUUID() + "_" + originalFilename; try { // 使用MultipartFile接口的方法完成文件上传到指定位置 file.transferTo(new File(dirPath + newFilename)); } catch (Exception e) { e.printStackTrace(); return "error"; } } // 跳转到成功页面 return "success"; } else { return "error"; } }

在上述代码中，包含一个MultipartFile接口类型的参数file，上传到程序中的亿华云文件是被封装在该参数中的。

org.springframework.web.multipart.MultipartFile接口中提供了获取上传文件、文件名称等方法，如下表所示：

代码实现：

fileUpload.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8" %> <!DOCTYPE html> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>文件上传</title> <script> // 判断是否填写上传人并已选择上传文件 function check() { var name = document.getElementById("name").value; var file = document.getElementById("file").value; if (name == "") { alert("填写上传人"); return false; } if (file.length == 0 || file == "") { alert("请选择上传文件"); return false; } return true; } </script> </head> <body> <form action="${ pageContext.request.contextPath }/fileUpload" method="post" enctype="multipart/form-data" onsubmit="return check()"> 上传人：<input id="name" type="text" name="name"/><br/> 请选择文件：<input id="file" type="file" name="uploadfile" multiple="multiple"/><br/> <input type="submit" value="上传"/> </form> </body> </html>

2. 文件下载

文件下载就是将文件服务器中的文件下载到本机上。在Spring MVC环境中，实现文件下载大致可分为如下两个步骤：

在客户端页面使用一个文件下载的超链接，该链接的href属性要指定后台文件下载的方法以及文件名(需要先在文件下载目录中添加了一个名称为“1.jpg”的文件)。

在后台使用Spring MVC提供的ResponseEntity类型对象完成文件下载，使用它可以很方便的定义返回的HttpHeaders对象和HttpStatus对象，通过对这两个对象的设置，即可完成下载文件时所需的配置信息。

@RequestMapping("/download") public ResponseEntity<byte[]> fileDownload(HttpServletRequest request, String filename) throws Exception { // 指定要下载的文件所在路径 String path = request.getServletContext().getRealPath("/upload/"); // 创建该文件对象 File file = new File(path + File.separator + filename); // 对文件名编码，防止中文文件乱码 filename = this.getFilename(request, filename); // 设置响应头 HttpHeaders headers = new HttpHeaders(); // 通知浏览器以下载的方式打开文件 headers.setContentDispositionFormData("attachment", filename); // 定义以流的形式下载返回文件数据 headers.setContentType(MediaType.APPLICATION_OCTET_STREAM); // 使用Sring MVC框架的ResponseEntity对象封装返回下载数据 return new ResponseEntity<byte[]>(FileUtils.readFileToByteArray(file), headers, HttpStatus.OK); }

文件下载中的ResponseEntity对象有些类似前面章节中的@ResponseBody注解，云服务器提供商它用于直接返回结果对象。

响应头信息中的MediaType代表的是Interner Media Type(即互联网媒体类型)，也叫做MIME类型，MediaType.APPLICATION_OCTET_STREAM的值为application/octet-stream，即表示以二进制流的形式下载数据;

HttpStatus类型代表的是Http协议中的状态，示例中的HttpStatus.OK表示200，即服务器已成功处理了请求。

当对中文名文件下载时会怎样?

当对中文名称的文件进行下载时，因为各个浏览器内部转码机制的不同，就会出现不同的乱码以及解析异常问题。

如何解决中文名文件下载乱码问题呢?

为了解决浏览器中文件下载时中文名称的乱码问题，可以在前端页面发送请求前先对中文名进行统一编码，然后在后台控制器类中对文件名称进行相应的转码。

在下载页面中对中文文件名编码。可以使用Servlet API中URLEncoder.encoder(String s, String enc)方法将中文转为UTF-8编码。

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@page import="java.net.URLEncoder"%> ... <body> <a href="${ pageContext.request.contextPath }/download?filename=<%=URLEncoder.encode(“ 壁纸.jpg", "UTF-8")%>"> 中文名称文件下载 </a> </body> </html>

在控制器类中编写对中文名文件下载时进行转码编码的方法。

public String getFilename(HttpServletRequest request,String filename) throws Exception { String[] IEBrowserKeyWords = { "MSIE", "Trident", "Edge"}; String userAgent = request.getHeader("User-Agent"); for (String keyWord : IEBrowserKeyWords) { if (userAgent.contains(keyWord)) { return URLEncoder.encode(filename, "UTF-8"); } } return new String(filename.getBytes("UTF-8"), "ISO-8859-1"); }