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


    目录


    上传文件的表单要求

    Spring MVC实现上传文件

    需要导入的jar包

    配置MultipartResolver解析器

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

    Spring MVC实现文件下载

    下载文件时的header设置

    编写文件下载的控制器

    Spring MVC配置异常跳转的页面

    配置异常页面的介绍

    配置ExceptionResolver解析器

     


    上传文件的表单要求

      对于普通表单来说,有几个注意点:

      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:UsersAdministratorDesktopcode.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>
    

      

  • 相关阅读:
    latex入门
    Cookie/Session和Token是什么
    Hive优化
    利用个人电脑搭建网站WEB服务器域名访问
    发布方配模板引擎V2.1及开发教程和案例
    PhpWind论坛系统一键安装
    替代微软IIS强大的HTTP网站服务器工具
    方配网站服务器(FPWebServer) V2.1 支持ASP、ASP.NET、PHP的运行
    Discuz_X2 论坛系统一键安装
    正式发布方配网站服务器V3.0
  • 原文地址:https://www.cnblogs.com/-beyond/p/10539656.html
Copyright © 2020-2023  润新知