SpringMVC框架06——文件上传与下载
1、文件上传
Spring MVC框架的文件上传是基于commons-fileupload组件的文件上传，只不过Spring MVC框架在原有文件上传组件上做了进一步封装，简化了文件上传的代码实现。
1.1、单文件上传
需要commons-fileupload组件相关依赖
<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>
页面中的form表单上添加多部件属性，fileupload.jsp
<form action="${pageContext.request.contextPath}/onefile" method="post" enctype="multipart/form-data"> 选择文件：<input type="file" name="myfile"><br> 文件描述：<input type="text" name="description"><br> <input type="submit" value="上传"> </form>
enctype属性指定的是表单数据的编码方式，该属性有以下3个值：
- application/x-www-form-urlencoded：默认的编码方式，只处理表单域里的value属性值；
- multipart/form-data：以二进制流的方式来处理表单数据，并将文件域指定文件的内容封装到请求参数里；
- text/plain：只有当表单的action属性为mailto:URL的形式时才使用，主要适用于直接通过表单发送邮件的方式。
创建POJO实体类
import org.springframework.web.multipart.MultipartFile; public class FileDomain { private String description; private MultipartFile myfile; //getter和setter }
在实体类中声明MultipartFile类型的属性封装被上传的文件信息，属性名与文件上传页面fileupload.jsp中的file类型的表单参数名myfile相同。
创建控制器类
@Controller public class FileUploadController { @RequestMapping("/onefile") public String oneFileUpload(@ModelAttribute FileDomain fileDomain, HttpServletRequest request){ //文件上传的位置 String realpath = request.getServletContext().getRealPath("uploadfiles"); //上传文件的名称 String fileName = fileDomain.getMyfile().getOriginalFilename(); File targetFile = new File(realpath,fileName); if(!targetFile.exists()){ targetFile.mkdirs();//创建目录 } try { fileDomain.getMyfile().transferTo(targetFile); System.out.println("文件上传成功"); } catch (Exception e){ e.printStackTrace(); } return "showFile"; } }
配置springmvc.xml
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"></bean>
创建showFile.jsp用于展示结果：
<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %> <html> <head> <title>文件上传信息</title> </head> <body> 文件名称：${fileDomain.myfile.originalFilename}<br> 文件描述：${fileDomain.description} </body> </html>
上传页面展示：
上传结果展示：
注意事项：
- 在上传页面fileupload.jsp中，form表单一定要加enctype属性，值为multipart/form-data，表单提交方式设置为post；
- form表单中的file标签的name属性要和实体类的MultipartFile属性的名称保持一致；
- 要在springmvc.xml中使用CommonsMultipartResolver类配置multipartResolver用于文件上传；
1.2、多文件上传
创建multifiles.jsp文件上传页面：
<form action="${pageContext.request.contextPath}/multifile" method="post" enctype="multipart/form-data"> <p> 选择文件1：<input type="file" name="myfile"><br> 文件描述1：<input type="text" name="description"> </p> <p> 选择文件2：<input type="file" name="myfile"><br> 文件描述2：<input type="text" name="description"> </p> <p> 选择文件3：<input type="file" name="myfile"><br> 文件描述3：<input type="text" name="description"> </p> <p> <input type="submit" value="提交"> </p> </form>
创建POJO类：
public class MultiFileDomain { private List<String> description; private List<MultipartFile> myfile; //getter和setter }
创建Controller类，接收上传参数：
@Controller public class FileUploadController { //多文件上传 @RequestMapping("/multifile") public String multiFileUpload(@ModelAttribute MultiFileDomain multiFileDomain,HttpServletRequest request){ String realpath = request.getServletContext().getRealPath("uploadfiles"); File targetDir = new File(realpath); if(!targetDir.exists()){ targetDir.mkdirs(); } List<MultipartFile> files = multiFileDomain.getMyfile(); for (int i=0;i<files.size();i++){ MultipartFile file = files.get(i); String fileName = file.getOriginalFilename(); File targetFile = new File(realpath,fileName); //上传 try { file.transferTo(targetFile); } catch (Exception e){ e.printStackTrace(); } } System.out.println("文件上传成功！"); return "showMulti"; } }
创建成功信息页面showMulti.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <html> <head> <title>多文件上传结果</title> </head> <body> <table width="50%" border="1"> <tr> <td>文件名</td> <td>详情</td> </tr> <c:forEach var="des" items="${multiFileDomain.description}" varStatus="loop"> <tr> <td>${multiFileDomain.myfile[loop.count-1].originalFilename}</td> <td>${des}</td> </tr> </c:forEach> </table> </body> </html>
测试多文件上传
上传结果：
2、文件下载
2.1、文件下载相关介绍
实现文件下载有两种方法：一种是通过超链接实现下载，另一种是利用程序编码实现下载。通过超链接实现下载比较简单，但是会暴露下载文件的真实位置，利用程序编码实现下载可以增加安全访问控制。
利用程序实现下载需要设置两个报头：
（1）设置Content-Type的值为application/x-msdownload
这项设置主要是为了告诉浏览器，其所输出内容的类型不是普通文本文件或HTML文件，而是一个要保存到本地的下载文件。
（2）设置Content-Disposition的值为attachment，并且在后面指定filename参数
这项设置主要是让浏览器不要直接处理相应的实体内容，而是由用户选择将相应的实体内容保存到一个文件中。该报头指定了接收程序处理数据内容的方式，在HTTP应用中只有attachment是标准方式，attachment表示要求用户干预。在attachment后面还可以指定filename参数，该参数是服务器建议浏览器将实体内容保存到文件中的文件名称。
设置报头的示例代码如下：
//设置下载文件使用的报头 response.setHeader("Content-Type","application/x-msdownload"); response.setHeader("Content-Disposition","attachment;filename="+filename);
2.2、文件下载的功能实现
创建FileDownController类，并编写下载功能的方法：
@Controller public class FileDownController { @RequestMapping("/down") public String down(@RequestParam String filename, HttpServletRequest request, HttpServletResponse response){ String filePath = null; //要下载的文件路径 FileInputStream in = null; //输入流 ServletOutputStream out = null; //输出流 try { //文件下载路径 filePath = request.getServletContext().getRealPath("uploadfiles"); //设置下载文件使用的报头 response.setHeader("Content-Type","application/x-msdownload"); response.setHeader("Content-Disposition","attachment;filename="+toUTF8String(filename)); //读入文件 in = new FileInputStream(filePath+"\\"+filename); //得到响应对象的输出流，用于向客户端输出二进制数据 out = response.getOutputStream(); out.flush(); int aRead = 0; byte[] b = new byte[1024]; while ((aRead=in.read(b))!=-1 && in!=null){ out.write(b,0,aRead); } out.flush(); in.close(); out.close(); } catch (Exception e) { e.printStackTrace(); } System.out.println("下载成功！"); return null; } /** * 下载保存时中文文件名的字符编码转换方法 */ public String toUTF8String(String str){ StringBuffer sb = new StringBuffer(); int len = str.length(); for (int i=0;i<len;i++) { //取出字符中的每个字符 char c = str.charAt(i); //Unicode码值为0-255时，不做处理 if(c>=0 && c<=255){ sb.append(c); }else{ //转换UTF-8编码 byte[] b; try { b = Character.toString(c).getBytes("UTF-8"); } catch (Exception e){ e.printStackTrace(); b = null; } //转换为%HH的字符串形式 for (int j=0;j<b.length;j++){ int k = b[j]; if(k<0){ k&=255; } sb.append("%"+Integer.toHexString(k).toUpperCase()); } } } return sb.toString(); } }
创建页面展示可下载文件的Controller类和方法：
@RequestMapping("/show")
public String show(HttpServletRequest request, Model model){
//文件下载路径
String realPath = request.getServletContext().getRealPath("uploadfiles");
File dir = new File(realPath);
File[] files = dir.listFiles();
//获取该目录下的所有文件名
ArrayList<String> fileNames = new ArrayList<String>();
for (int i=0;i<files.length;i++) {
fileNames.add(files[i].getName());
}
model.addAttribute("files",fileNames);
return "showDown";
}
创建用于文件下载展示的showDown.jsp页面
<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %> <%@ taglib prefix="c" uri="http://java.sun.com/jsp/jstl/core" %> <html> <head> <title>文件下载</title> </head> <body> <table width="50%" border="1"> <tr> <th>文件名</th> <th>操作</th> </tr> <c:forEach var="filename" items="${files}"> <tr> <td>${filename} </td> <td> <a href="${pageContext.request.contextPath}/down?filename=${filename}">下载</a> </td> </tr> </c:forEach> </table> </body> </html>
效果展示：
点击下载链接
