SpringMVC学习笔记(3)

阅读数: 次 2021-12-01

文章导航

SpringMVC学习笔记

🌷🌷🌷

文件上传和下载，拦截器，异常处理，运行流程…

文件下载

一. HttpMessageConverter

HttpMessageConverter\是 Spring3.0 新添加的一个接口，负责将请求信息转换为一个对象（类型为 T），将对象（类型为 T）输出为响应信息。

二. 使用HttpMessageConverter

使用 HttpMessageConverter 将请求信息转化并绑定到处理方法的入参中或将响应结果转为对应类型的响应信息，Spring 提供了两种途径：

使用 @RequestBody / @ResponseBody 对处理方法进行标注
使用 HttpEntity / ResponseEntity 作为处理方法的入参或返回值

三. 文件下载

1). jsp页面

1
2
3

<body>
  <a href="down/1.png">下载图片</a>
</body>

2). 控制层文件

图片目录

@Controller
public class TestUploadAndDownController {

	@RequestMapping("/down/{fileName:.+}")
	public ResponseEntity<byte[]> down(HttpSession session,@PathVariable("fileName") String fileName) throws IOException{
		
		//获取下载文件路径
		String realPath = session.getServletContext().getRealPath("img");
		String finalPath = realPath + File.separator + fileName;
		InputStream is = new FileInputStream(finalPath);
		//获取输入流所读取的文件最大字节数
		byte[] body = new byte[is.available()];
		is.read(body);
		//创建请求头
		HttpHeaders headers = new HttpHeaders();
		headers.add("Content-Disposition", "attachment;filename=abc.txt");
		//设置状态响应
		HttpStatus status =HttpStatus.OK;

		ResponseEntity<byte[]> entity = new ResponseEntity<byte[]>(body, headers, status);		
		return entity;
	}
}

文件上传

一. 简介

Spring MVC 为文件上传提供了直接的支持，这种支持是通过即插即用的 MultipartResolver 实现的。
Spring 用 Jakarta Commons FileUpload 技术实现了一个 MultipartResolver 实现类：CommonsMultipartResovler 。
Spring MVC 上下文中默认没有装配 MultipartResovler，因此默认情况下不能处理文件的上传工作，如果想使用 Spring 的文件上传功能，需现在上下文中配置 MultipartResolver。

二. 文件上传

1). jsp页面

<body>
  <form action="up_old" method="post" enctype="multipart/form-data">
  	头像:<input type="file" name="uploadFile"/>
  	描述:<input type="text" name="desc"/>
  	<input type="submit" value="上传"/>
  </form>
  <hr/>
  <form action="up" method="post" enctype="multipart/form-data">
  	头像:<input type="file" name="uploadFile"/>
  	描述:<input type="text" name="desc" value="解决重名问题！"/>
  	<input type="submit" value="上传"/>
  </form>
</body>

2). 控制层文件

上传文件的jar包

@Controller
public class TestUploadAndDownController {

    @RequestMapping(value="/up_old",method=RequestMethod.POST)
	public String up_old(String desc,MultipartFile uploadFile,HttpSession session)throws IOException{
//		//获得表单元素的name属性
//		String name = uploadFile.getName();
		//文件名称
		String filename = uploadFile.getOriginalFilename();
		String path = session.getServletContext().getRealPath("photo") + File.separator + filename;
		//获取输入流
		InputStream is = uploadFile.getInputStream();
		File file = new File(path);
		//获取输出流
		FileOutputStream os = new FileOutputStream(file);
		int i = 0;
		byte[] b = new byte[4096];
		while((i= is.read(b)) != -1){
			os.write(b,0,i);
		}
		os.close();
		is.close();
		return "success";
	}

	@RequestMapping(value="/up",method=RequestMethod.POST)
	public String up(String desc,MultipartFile uploadFile,HttpSession session)throws IOException{
		//文件名称
		String filename = uploadFile.getOriginalFilename();
		String finalFileName = UUID.randomUUID() + filename.substring(filename.lastIndexOf("."));
		String path = session.getServletContext().getRealPath("photo") + File.separator + finalFileName;
		File file = new File(path);
		uploadFile.transferTo(file);
		
		return "success";
	}
}

3). SpringMVC配置文件

<!-- 扫描所有组件 -->
<context:component-scan base-package="com.teng"/>

<!-- 配置一个视图解析器，可以拼接页面地址 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
	<property name="prefix" value="/WEB-INF/view/"></property>
	<property name="suffix" value=".jsp"></property>
</bean>

<!-- 默认Servlet处理静态资源 -->
<mvc:default-servlet-handler/>

<!-- 开启mvc注解驱动模式 -->
<mvc:annotation-driven/>

<!-- 文件处理，将客户端上传的File文件，处理为MultipartFile -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
	<!-- 设置文件解析的编码（需要和页面中的pageEncoding保持一致） -->
	<property name="defaultEncoding" value="UTF-8"/>
	<!-- 最大上传文件字节大小 -->
	<property name="maxUploadSize" value="9999999"/>
</bean>

三. 多个文件上传

多文件

拦截器

一. 简介

Spring MVC也可以使用拦截器对请求进行拦截处理，用户可以自定义拦截器来实现特定的功能，自定义的拦截器必须实现HandlerInterceptor接口。
- preHandle()：这个方法在业务处理器处理请求之前被调用，在该方法中对用户请求 request 进行处理。如果程序员决定该拦截器对请求进行拦截处理后还要调用其他的拦截器，或者是业务处理器去进行处理，则返回true；如果程序员决定不需要再调用其他的组件去处理请求，则返回false。
- postHandle()：这个方法在业务处理器处理完请求后，但是DispatcherServlet 向客户端返回响应前被调用，在该方法中对用户请求request进行处理。
- afterCompletion()：这个方法在 DispatcherServlet 完全处理完请求后被调用，可以在该方法中进行一些资源清理的操作。

二. 拦截器使用

1). jsp页面

1
2
3

<body>
  <a href="testInterceptor">测试拦截器执行顺序</a>
</body>

2). 控制层文件

@Controller
public class TestInterceptorController {

	/**
	 * 当有多个拦截器时，
	 * 	preHandle：按照拦截器数组的正向循序执行
	 * 	postHandle：按照拦截器数组的反向循序执行（出现错误，不会执行）
	 * 	afterCompletion：按照拦截器数组的反向循序执行
	 * 
	 * 当多个拦截器的preHandle返回值不同时
	 * 	当两个都返回false：只会执行第一个的preHandle；
	 * 	当第一个返回true，第二个返回false：[全部]拦截器的preHandle都会执行，[全部]postHandle都不会执行，afterCompletion只有第一个会执行[返回false之前的]；
	 * 	当第一个返回false，第二个返回true：只会执行第一个的preHandle；
	 */
	@RequestMapping("/testInterceptor")
	public String testInterceptor(){
//		int i = 1/0;
		return "success";
	}
}

3). 拦截器文件

@Component
public class FirstInterceptor implements HandlerInterceptor{

	@Override
	public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
			throws Exception {
		System.out.println("First:preHandle");
		return true;
	}

	@Override
	public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
			ModelAndView modelAndView) throws Exception {
		System.out.println("First:postHandle");
		
	}

	@Override
	public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
			throws Exception {
		System.out.println("First:afterCompletion");
		
	}
	
}

4). SpringMVC配置文件

	<!-- 配置一个拦截器 -->
	<mvc:interceptors>
		<!-- 默认拦截所有请求 -->
		<bean class="com.teng.interceptor.FirstInterceptor"/>
		<bean class="com.teng.interceptor.SecondInterceptor"/>
 		<!-- 此方法要求拦截器加@Component注解 -->
<!--	<ref bean="firstInterceptor"/> -->

		<!-- 设置自定义拦截方式 -->
<!-- 		<mvc:interceptor>
			<bean></bean>
			<mvc:mapping path=""/>
			<mvc:exclude-mapping path=""/>
		</mvc:interceptor> -->
	</mvc:interceptors>

三. 多个拦截器执行顺序

1). 添加另一个拦截器

@Component
public class SecondInterceptor implements HandlerInterceptor{

	@Override
	public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
			throws Exception {
		System.out.println("Second:preHandle");
		return true;
	}

	@Override
	public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
			ModelAndView modelAndView) throws Exception {
		System.out.println("Second:postHandle");
		
	}

	@Override
	public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
			throws Exception {
		System.out.println("Second:afterCompletion");
		
	}
	
}

2). 执行顺序

多个拦截器执行顺序

异常处理

一. 简介

Spring MVC 通过 HandlerExceptionResolver 处理程序的异常，包括 Handler 映射、数据绑定以及目标方法执行时发生的异常。

二. 异常处理 DefaultHandlerExceptionResolver

系统默认的异常处理器，对一些特殊的异常进行处理，比如：

NoSuchRequestHandlingMethodException
HttpRequestMethodNotSupportedException
HttpMediaTypeNotSupportedException
HttpMediaTypeNotAcceptableException等

三. 异常处理 SimpleMappingExceptionResolver

自定义的异常处理器如果希望对所有异常进行统一处理，可以使用 SimpleMappingExceptionResolver，它将异常类名映射为视图名，即发生异常时使用对应的视图报告异常。

1). jsp页面

index.jsp

1
2
3

 <body>
<a href="testException">测试异常</a>
 </body>

error.jsp

1
2
3

<body>
  <h2>操作异常，请稍后重试...(${exception})</h2><br>
</body>

2). 控制层文件

@Controller
public class TestExceptionController {
	
	@RequestMapping(value="/testException",method=RequestMethod.GET)
	public String testException(){
		String s = null;
		System.out.println(s.substring(0,3));
		return "success";
	}
}

3). SpringMVC配置文件

<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
	<!-- 配置异常解析器 -->
	<property name="exceptionMappings">
		<props>
			<!-- 拦截某种类型的异常 -->
			<prop key="java.lang.NullPointerException">error</prop>
		</props>
	</property>
</bean>

SpringMVC工作流程

流程图

一. 工作流程描述

1). 用户向服务器发送请求，请求被SpringMVC 前端控制器 DispatcherServlet捕获；

2). DispatcherServlet对请求URL进行解析，得到请求资源标识符（URI）:
判断请求URI对应的映射

①.不存在：
- a)再判断是否配置了mvc:default-servlet-handler：
  - b)如果没配置，则控制台报映射查找不到，客户端展示404错误
  - c)如果有配置，则执行目标资源（一般为静态资源，如：JSP,HTML）
②.存在：
- a)执行下面流程

3). 根据该URI，调用HandlerMapping获得该Handler配置的所有相关的对象（包括Handler对象以及Handler对象对应的拦截器），最后以HandlerExecutionChain对象[某个指定的请求和处理关系] 的形式返回；

4). DispatcherServlet 根据获得的Handler，选择一个合适的HandlerAdapter**。

5). 如果成功获得HandlerAdapter后，此时将开始执行拦截器的preHandler(…)方法【正向】

6). 提取Request中的模型数据，填充Handler入参，开始执行Handler（Controller)方法，处理请求。在填充Handler的入参过程中，根据你的配置，Spring将帮你做一些额外的工作：

①.HttpMessageConveter： 将请求消息（如Json、xml等数据）转换成一个对象，将对象转换为指定的响应信息
②.数据转换：对请求消息进行数据转换。如String转换成Integer、Double等
③.数据根式化：对请求消息进行数据格式化。如将字符串转换成格式化数字或格式化日期等
④.数据验证：验证数据的有效性（长度、格式等），验证结果存储到BindingResult或Error中

7). Handler执行完成后，向DispatcherServlet 返回一个ModelAndView对象；

8). 此时将开始执行拦截器的postHandle(…)方法【逆向】

9). 根据返回的ModelAndView（此时会判断是否存在异常：如果存在异常，则执行HandlerExceptionResolver进行异常处理）选择一个适合的ViewResolver（必须是已经注册到Spring容器中的ViewResolver)返回给DispatcherServlet，根据Model和View，来渲染视图

10). 在返回给客户端时需要执行拦截器的AfterCompletion方法【逆向】

11). 将渲染结果返回给客户端

本文作者： 腾飞
本文链接： https://www.tengfei.eu.org/article/af57c6ea.html
版权声明： 本作品采用知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议进行许可。转载请注明出处！