SpringMVC 实现文件上传与下载，并配置异常页面

上传文件的表单要求

　　对于普通表单来说，有几个注意点：

　　1、action：表示要提交到哪里；

　　2、method：表单提交的方式，常用的有post和get两种，不写的话，默认是get；提交文件是只能使用post方式。

　　3、enctype：编码类型，表示提交的数据是什么格式。有三个值，

　　　　1）不显式设置enctype时，默认是application/x-www-form-urlencoded，表示提交的是普通的数据；

　　　　2）text/plain，表示提交的是文本数据，数据量稍大一点。

　　　　3）multipart/form-data，这种方式可以提交二进制数据（音频、图像等文件）

　　综上，如果要上传文件，必须要将method设置为post，然后将enctype设置multipart/form-data。另外，上传文件的input标签的type属性设置为file。

<form action="upload" method="post" enctype="multipart/form-data">

	<input type="file" name="myfile" />

	<input type="submit" name="submit" value="upload" />

</form>

Spring MVC实现上传文件

　　在看Spring MVC是怎么实现文件上传之前，可以先看一下不是框架，使用原生的servlet开发是怎么实现文件上传的：Servlet 实现文件上传与下载

　　在Servlet 3.0之后，Spring MVC实现文件上传主要是使用一个叫MultipartResolver的解析器，该解析器依赖于apache的commons-io和commons-fileupload。MultipartResolver会自动解析文件，之后我们在handlerMethod中，可以很方便的操作上传的文件。

　　需要导入的jar包

　　必不可少的commons-io.jar和commons-fileupload.jar这两个包，缺一不可。

配置MultipartResolver解析器

　　MultipartResolver是一个interface，我们只需要配置他的一个实现类，比如CommonsMultipartResolver这个实现类，配置的方法也很简单，只需要配置一个id为multipartResolver的<bean>即可。

　　在Spring MVC的配置文件中增加下面配置：

<!-- 创建MultipartResolver解析器 -->

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">

	<!-- 配置属性，可以省略不配置，设置上传的文件maxSize，单位为B（字节） -->

	<property name="maxUploadSize" value="1000000"></property>

</bean>

　　编写接收上传文件的控制器

package cn.ganlixin.controller;

import java.io.File;

import java.io.IOException;

import java.util.UUID;

import org.apache.commons.io.FileUtils;

import org.springframework.stereotype.Controller;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.multipart.MultipartFile;

@Controller

public class UploadController {

	@RequestMapping("upload")

	// 注意表单中文件input的name要和这里的参数名相同。

	public String upload(MultipartFile myfile) throws IOException {

		// 上传一张图片 C:\Users\Administrator\Desktop\code.png

		// 获取文件的原始名称

		String originalFileName = myfile.getOriginalFilename();  // code.png

		// 获取上传文件的表单中，input的name值，其实就是myfile（就是接收时的名称）

		String fileName = myfile.getName();		// myfile

		// 获取上传的文件大小，单位为字节

		long fileSize = myfile.getSize();		// 5823（字节）

		String extensionName = originalFileName.substring(originalFileName.lastIndexOf("."));

		/*

		进行一些过滤判断操作

		 */

		// 利用apache的commons-io和commons-fileupload,将文件保存到硬盘中，文件名可以根据自己的规则来定，这里使用UUID

		String newFileName = UUID.randomUUID().toString();

		FileUtils.copyInputStreamToFile(

				myfile.getInputStream(),

				new File("E:/uploads/" + newFileName + extensionName)

		);

		return "/success.jsp";

	}

}

Spring MVC实现文件下载

　　在原生servlet实现文件下载主要有两步：

　　1、使用HttpServletRequest对象接收请求，获取客户端想要下载的文件名；

　　2、读取需要下载的文件，然后使用HttpServletResponse对象向客户端输出文件的字节流。

　　其实Spring MVC实现文件下载和使用原生servlet实现文件下载的方式并没有太大区别，甚至可以说没有任何区别。唯一的区别就是Spring MVC的控制器没有继承HttpServlet，但是却可以为HandlerMethod注入HttpServletRequest和HttpServletResponse对象，之后就可以进行和原生servlet相同的操作了。

　　下载文件时的header设置

　　先看一下提供下载文件的资源链接：

<a href="download?fileName=info.txt">点击下载info.txt</a>

<a href="download?fileName=data.rar">点击下载data.rar</a>

　　如果仍旧按照以前的设置：Content-Type=text/html; charset=utf-8; 那么当客户端点击下载链接时，发生的事情可能超乎预料。上面这两个资源链接的文件的扩展名，扩展名指明了该文件的格式。如果没有设置文件以附件形式下载，那么对于不同的浏览器，对于文件的处理方式是不同的：

　　1、如果浏览器能够打开或者能够解析该类型文件，那么，文件就会直接被浏览器打开（注意，不是下载，不会保存到用户的本地磁盘）；

　　2、如果浏览器不能打开或者不能解析该类型的文件，那么，浏览器才会将文件下载下来（保存到用户磁盘）。

　　比如，当服务器响应info.txt之后，浏览器接收到info.txt，info.txt是文本文件，浏览器可以打开，于是就会将info.txt的内容显示在浏览器的页面中，而没有下载下来。而对于data.rar来说，浏览器无法直接打开，所以会下载到本地。

　　为了让用户请求下载的文件都能保存到用户磁盘（即使浏览器能够打开文件，也不要让他打开，而只是让他进行下载），可以设置Content-Disposition属性为attachment（通知浏览器以附件形式下载）。

　　编写文件下载的控制器

package cn.ganlixin.controller;

import java.io.File;

import java.io.IOException;

import javax.servlet.ServletOutputStream;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import org.apache.commons.io.FileUtils;

import org.springframework.stereotype.Controller;

import org.springframework.web.bind.annotation.RequestMapping;

import org.springframework.web.bind.annotation.ResponseBody;

@Controller

public class DownloadController {

	@RequestMapping("/download")

	// 注入fileName、request、response

	public void download(String fileName,

			HttpServletRequest request, HttpServletResponse response) throws IOException {

		// 设置响应是以附件形式，不用设置Content-Type了

		response.setHeader("Content-Disposition", "attachment; filename=" + fileName);

		// 获取文件的真实路径（可供下载的文件都放在/project/WebContext/files/路径下，但是部署到服务器后，files文件夹的路径都会发生改变。

		// 所以需要重新获得该文件从根目录开始的路径，然后读取文件，并响应给客户端。

		String path = request.getServletContext().getRealPath("files");

		// 文件下载时，是使用字节流格式，所以不能使用response.getWriter()-->返回PrintWriter是字符流

		// 获取输出字节流恶意使用response.

		ServletOutputStream out = response.getOutputStream();

		File downloadFile = new File(path, fileName);

		// 判断文件是否存在

		if (! downloadFile.exists()) {

			request.setAttribute("msg", "文件不存在");

			response.sendError(404);

			return;

		}

		// 利用FileUtils将文件读入字节数组，然后返回给客户端。

		out.write(FileUtils.readFileToByteArray(downloadFile));

		out.flush();

		out.close();

	}

}

Spring MVC配置异常跳转的页面

　　配置异常跳转页面的介绍

　　我们的服务器在运行过程中可能会出现各种异常，当出现异常的时候，根据Java的脾气，一定会打印堆栈信息，这个信息不能直接暴露给用户，一个原因是打印的堆栈信息并不是用户关心的内容，会影响用户体验；另一方面，如果被黑客获取到堆栈信息，也是一种安全隐患。

　　所以我们在编程过程中，使用了很多try{ } catch{ }，每当出现异常XxxException，可以根据异常的类型，返回给客户一个特定的异常页面。这个返回异常的部分如果直接写在业务代码中也是可以的，但是却不是推荐的。

　　Spring MVC提供了一个ExceptionResolver解析器，这个解析器可以为我们做这么一个事情：根据我们自定义的配置，当出现某种Exception的时候，就直接跳转到指定的页面，不需要在逻辑代码中进行处理。

　　举个例子：当服务端接收客户端上传的文件时，发现文件的大小超过了设置的最大值，此时，如果配置MultipartResolver时设置了上传文件的最大值，那么此时就会出现org.springframework.web.multipart.MaxUploadSizeExceededException，出现异常时，异常堆栈信息也会显示给客户端，此时就可以配置下ExceptionResolver，当出现这个错误，就跳转到uploadFailed.jsp中。

　　配置ExceptionResolver解析器

　　配置ExceptionResolver解析器的方式也很简单，只需要配置一个id为exceptionResolver的<bean>即可，class可以是ExceptionResolver的一个实现实现类。

<!-- 配置ExceptionResolver解析器 -->

<bean id="exceptionResolver" class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">

	<!-- 配置异常与跳转页面的对应关系 -->

	<property name="exceptionMappings">

		<props>

			<prop key="org.springframework.web.multipart.MaxUploadSizeExceededException">/uploadFailed.jsp</prop>

		</props>

	</property>

</bean>