SpringMVC之HandlerInterceptor拦截器详解

Posted 2021-10-23 敲代码的小小酥

HandlerInterceptor接口

总体注释翻译:

允许自定义处理程序执行链的工作流接口。应用程序可以为某些处理程序组注册任意数量的现有或自定义拦截器，以添加公共预处理行为，而无需修改每个处理程序实现。
在适当的HandlerAdapter触发处理程序本身的执行之前，会调用HandlerInterceptor。此机制可用于大量预处理方面，例如授权检查，或常见的处理程序行为，如区域设置或主题更改。它的主要目的是允许分解出重复的处理程序代码。
通常，拦截器链是根据HandlerMappingbean定义的，共享其粒度。为了能够将某个拦截器链应用于一组处理程序，需要通过一个HandlerMapping bean映射所需的处理程序。拦截器本身被定义为应用程序上下文中的bean，映射bean定义通过其“interceptors”属性（在XML:a的中）引用拦截器。
HandlerInterceptor基本上类似于Servlet过滤器，但与后者不同的是，它只允许自定义预处理，并可以选择禁止执行处理程序本身，以及自定义后处理。过滤器功能更强大，例如，它们允许交换传递链中的请求和响应对象。注意，过滤器是在web.xml中配置的，web.xml是应用程序上下文中的HandlerInterceptor。
作为一项基本指导原则，与细粒度处理程序相关的预处理任务是HandlerInterceptor实现的候选任务，特别是考虑了常见处理程序代码和授权检查。另一方面，过滤器非常适合于请求内容和视图内容处理，如多部分表单和GZIP压缩。这通常显示何时需要将筛选器映射到某些内容类型（例如图像）或所有请求。

通过上面的描述，我们做一下总结:
首先,SpringMVC的拦截器与Servlet的Filter过滤器是有本质区别的，具体区别可以参考这篇文章:springMVC过滤器与servlet拦截器区别
第二，通过上面对注释的翻译可知，SpringMVC拦截器设置的初衷是解决一些重复性工作，无需在每个Controlelr中重复书写代码，比如:权限校验，请求内容和视图内容处理，如多部分表单和GZIP压缩等。

接口方法:

default boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
			throws Exception {

		return true;
	}

在HandlerMapping确定适当的处理程序对象之后，但在HandlerAdapter调用处理程序之前调用。
DispatcherServlet处理执行链中的处理程序，该执行链由任意数量的拦截器组成，处理程序本身位于末尾。使用此方法，每个拦截器可以决定中止执行链，通常发送HTTP错误或编写自定义响应。

default void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
			@Nullable ModelAndView modelAndView) throws Exception {
	}

拦截处理程序的执行。在HandlerAdapter实际调用处理程序之后调用，但在DispatcherServlet呈现视图之前调用。可以通过给定的ModelAndView向视图公开其他模型对象。可以通过此方法改变ModleAndView返回值。

default void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler,
			@Nullable Exception ex) throws Exception {
	}

请求处理完成后（即呈现视图后）回调。将在处理程序执行的任何结果上调用，从而允许适当的资源清理。
注意：仅当此拦截器的预处理方法已成功完成并返回true时才会调用！

上述三个方法分别在我们定义的Controller业务方法执行之前；执行完之后，还没返回ModelAndView时；返回数据后进行拦截和处理。根据不同的业务需求，制定不同的拦截器。

拦截器的粒度:
SpringMVC拦截器可通过配置拦截路径，精细的拦截某个路径，或不拦截某个路径。