目录
1 拦截器介绍
2 创建一个拦截器类
3 配置拦截器
1 拦截器介绍
在 SpringMVC 中，拦截器 (Interceptor) 是一种用于拦截 HTTP 请求并在请求处理之前或之后执行自定义逻辑的组件。拦截器可以用于实现以下功能：
- 权限验证：在请求处理之前进行用户身份验证和授权
- 日志记录：记录请求的相关信息，如请求路径、参数、处理时间等
- 异常处理：捕获并处理请求处理过程中抛出的异常
- 性能监控：统计请求的响应时间、吞吐量等性能指标
- 数据转换：在请求处理之前或之后对请求或响应的数据进行转换或修改
- 缓存控制：在请求处理之前检查缓存，决定是否从缓存中获取数据
从以上功能可以看出，拦截器和过滤器作用很相似，但它们存在一些区别。
- 层次结构：拦截器是 SpringMVC 框架特有的组件，不依赖 servlet 容器，过滤器是 Web 容器级别的组件，依赖 servlet 容器，可以应用于任何 Web 应用
- 拦截范围：拦截器只能对 SpringMVC 的请求起作用，而过滤器则可以对几乎所有的请求起作用。拦截器可以获取 Spring 容器中的各个 bean，而过滤器就不行，在拦截器注入一个 service，可以调用业务逻辑
- 触发时机：拦截器在 SpringMVC 的控制器方法被调用之前或之后触发，可以拦截并处理控制器方法的调用。过滤器在 HTTP 请求到达 Web 服务器之前或之后触发，可以在请求进入应用 (SpringMVC) 之前或响应返回给客户端之前进行处理
- 调用顺序：过滤器在拦截器之前被调用，它们都可以按照 XML 文件中的配置顺序依次执行或注解 @Order 指定的顺序执行
2 创建一个拦截器类
创建一个拦截器类需要实现 HandlerInterceptor 接口，该接口包括三个方法：preHandle、postHandle 和 afterCompletion。在这些方法中，可以编写拦截器的逻辑。
- preHandle：控制器方法执行之前执行 preHandle()，其 boolean 类型的返回值表示是否拦截或放行，返回 true 表示放行，即调用控制器方法；返回 false 表示拦截，即不调用控制器方法
- postHandle：控制器方法执行之后，渲染视图之前执行 postHandle()
- afterComplation：处理完视图和模型数据，渲染视图完毕之后执行 afterComplation()
public class CustomInterceptor implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
// 在处理器执行之前调用
String userName=request.getParameter("userName");
String password = request.getParameter("password");
if (userName==null||password==null){
response.setStatus(500);
response.setContentType("text/html; charset=UTF-8");
response.getWriter().print("参数缺失");
return false;
}
//进行用户校验
if (userName.equals("admin")&&password.equals("admin")){
return true; // 返回true继续执行，返回false中断执行
}else {
response.setStatus(500);
response.setContentType("text/html; charset=UTF-8");
response.getWriter().print("用户名或密码错误");
return false;
}
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
// 在处理器执行之后，返回ModelAndView之前调用
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
// 在整个请求处理完成后调用
}
}
3 配置拦截器
基于注解
addPathPatterns 用于设置拦截哪些请求，excludePathPatterns 用于设置不拦截哪些请求
@Configuration
public class MvcConfig implements WebMvcConfigurer {
@Autowired
private CustomInterceptor customInterceptor ;
@Override
public void addInterceptors(InterceptorRegistry registry) {
registry.addInterceptor(customInterceptor)
.addPathPatterns("/**")
.excludePathPatterns("/error");
}
}基于 XML
通过 <mvc:mapping> 设置需要拦截的请求，通过 <mvc:exclude-mapping> 设置需要排除的请求，即不需要拦截的请求
<mvc:interceptors>
<mvc:interceptor>
<!-- 拦截所有 URL -->
<mvc:mapping path="/**"/>
<!-- 不拦截 /testRequestEntity/ -->
<mvc:exclude-mapping path="/testRequestEntity"/>
<-- 拦截器类 -->
<bean class="com.example.CustomInterceptor" />
</mvc:interceptor>
</mvc:interceptors>注：对于多个拦截器，前面的拦截器不通过，即 preHandle() 返回 false，中断后续执行。
