# Spring MVC学习笔记(二)-拦截器,异常处理器,文件上传
[TOC]
## 拦截器的使用
### 监听器,过滤器与拦截器的对比
**监听器**:实现javax.servlet.ServletContextListener接口的服务端组件,随web应用启动而启动,只会初始化一次,随着web应用的停止而销毁
- 做一些初始化的动作.容器启动时的初始化工作
- 监听web中的特定事件,比如HttpSession,ServletRequest的创建和销毁,变量的创建和销毁,在某些动作前后增加处理,例如统计在线人数,利用HttpSessionListener等
**过滤器(Filter)**:
- 对Request请求起到过滤作用,在Servlet之前生效
- 例如使用编码过滤器,强制将所有参数以UTF-8编码
**拦截器(Interceptor)**:
- SpringMVC自有的拦截器,只会拦截访问的控制器方法,不会拦截静态资源
- servlet,filter,listener是配置在web.xml中的,interceptor是配置在MVC配置文件中的
- 拦截器会在业务逻辑执行前拦截一次,在业务逻辑执行完毕未跳转页面之前拦截一次,在跳转页面之后拦截一次

### 拦截器的处理流程

1. 程序先执⾏preHandle()⽅法,如果该⽅法的返回值为true,则程序会继续向下执⾏处理器中的⽅法,否则将不再向下执⾏。
2. 在业务处理器(即控制器Controller类)处理完请求后,会执⾏postHandle()⽅法,然后会通过DispatcherServlet向客户端返回响应。
3. 在DispatcherServlet处理完请求后,才会执⾏afterCompletion()⽅法。
### 多个拦截器的执行顺序
多个拦截器(假设有两个拦截器Interceptor1和Interceptor2,并且在配置⽂件中, Interceptor1拦截器配置在前),在程序中的执⾏流程如下图所示:

从图可以看出,当有多个拦截器同时⼯作时,它们的preHandle()⽅法会按照配置⽂件中拦截器的配置
顺序执⾏,⽽它们的postHandle()⽅法和afterCompletion()⽅法则会按照配置顺序的反序执⾏
### 声明拦截器代码
首先需要实现HandlerInterceptor接口,并在springMVC的配置文件中配置具体的拦截器配置
**实现接口类代码**:
```java
public class MyInterceptor01 implements HandlerInterceptor {
/**
* 会在handler方法业务逻辑执行之前执行
* 往往在这里完成权限校验工作
* @param request
* @param response
* @param handler
* @return 返回值boolean代表是否放行,true代表放行,false代表中止
* @throws Exception
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("MyIntercepter01 preHandle......");
return true;
}
/**
* 会在handler方法业务逻辑执行之后尚未跳转页面时执行
* @param request
* @param response
* @param handler
* @param modelAndView 封装了视图和数据,此时尚未跳转页面,你可以在这里针对返回的数据和视图信息进行修改
* @throws Exception
*/
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("MyIntercepter01 postHandle......");
}
/**
* 页面已经跳转渲染完毕之后执行
* @param request
* @param response
* @param handler
* @param ex 可以在这里捕获异常
* @throws Exception
*/
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("MyIntercepter01 afterCompletion......");
}
}
```
**配置文件**:
```xml
<mvc:interceptors>
<!--拦截所有handler-->
<!--<bean class="com.lagou.edu.interceptor.MyIntercepter01"/>-->
<mvc:interceptor>
<!--配置当前拦截器的url拦截规则,**代表当前目录下及其子目录下的所有url-->
<mvc:mapping path="/**"/>
<!--exclude-mapping可以在mapping的基础上排除一些url拦截-->
<!--<mvc:exclude-mapping path="/demo/**"/>-->
<bean class="com.lagou.edu.interceptor.MyIntercepter01"/>
</mvc:interceptor>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean class="com.lagou.edu.interceptor.MyIntercepter02"/>
</mvc:interceptor>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean class="com.lagou.edu.interceptor.MyInterceptor03"/>
</mvc:interceptor>
</mvc:interceptors>
```
## 如何在控制器中统一的处理异常-异常处理器
### 统一的处理方式
**使用ControllerAdvice注解**,对Controller进行统一的增强,@ExceptionHandler(ArithmeticException.class) 针对不同的异常进行不同的处理方式
```java
// 可以让我们优雅的捕获所有Controller对象handler方法抛出的异常
@ControllerAdvice
public class GlobalExceptionResolver {
@ExceptionHandler(ArithmeticException.class)
public ModelAndView handleException(ArithmeticException exception, HttpServletResponse response) {
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("msg",exception.getMessage());
modelAndView.setViewName("error");
return modelAndView;
}
}
```
### 针对某个Controller的处理方式
在Controller中写一个新的方法,并增加@ExceptionHandler对异常进行捕获,这里异常处理会更优先于全局的异常处理器
```java
// SpringMVC的异常处理机制(异常处理器)
// 注意:写在这里只会对当前controller类生效
@ExceptionHandler(ArithmeticException.class)
public void handleException(ArithmeticException exception,HttpServletResponse response) {
// 异常处理逻辑
try {
response.getWriter().write(exception.getMessage());
} catch (IOException e) {
e.printStackTrace();
}
}
```
## 上传文件
配置文件解析器:
```xml
<!--配置⽂件上传解析器,id是固定的multipartResolver-->
<bean id="multipartResolver"
class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--设置上传⼤⼩,单位字节-->
<property name="maxUploadSize" value="1000000000"/>
</bean>
```
前端:
```jsp
<%--
1 method="post"
2 enctype="multipart/form-data"
3 type="file"
--%>
<form method="post" enctype="multipart/form-data" action="/demo/upload">
<input type="file" name="uploadFile"/>
<input type="submit" value="上传"/>
</form>
```
后端接收:
```java
/**
* 文件上传
* @return
*/
@RequestMapping(value = "/upload")
public ModelAndView upload(MultipartFile uploadFile,HttpSession session) throws IOException {
// 处理上传文件
// 重命名,原名123.jpg ,获取后缀
String originalFilename = uploadFile.getOriginalFilename();// 原始名称
// 扩展名 jpg
String ext = originalFilename.substring(originalFilename.lastIndexOf(".") + 1, originalFilename.length());
String newName = UUID.randomUUID().toString() + "." + ext;
// 存储,要存储到指定的文件夹,/uploads/yyyy-MM-dd,考虑文件过多的情况按照日期,生成一个子文件夹
String realPath = session.getServletContext().getRealPath("/uploads");
String datePath = new SimpleDateFormat("yyyy-MM-dd").format(new Date());
File folder = new File(realPath + "/" + datePath);
if(!folder.exists()) {
folder.mkdirs();
}
// 存储文件到目录
uploadFile.transferTo(new File(folder,newName));
// TODO 文件磁盘路径要更新到数据库字段
Date date = new Date();
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("date",date);
modelAndView.setViewName("success");
return modelAndView;
}
```
Spring MVC学习笔记(二)-拦截器,异常处理器,文件上传