Spring 詳解（三）- SpringMVC攔截器使用

Spring 詳解（三）——- SpringMVC攔截器使用

2019 年 10 月 6 日
筆記

不攔截靜態資源

如果配置攔截類似於*.do格式的攔截規則，則對靜態資源的訪問是沒有問題的，但是如果配置攔截了所有的請求（如我們上面配置的「/」），就會造成js文件、css文件、圖片文件等靜態資源無法訪問。
攔截器的主要作用是是用於許可權管理，攔截不合理的URL，所以不對靜態資源進行攔截。
使用<mvc:resources/> (mapping：請求，location：映射地址，注意必須是webapp根目錄下的路徑。)

spring配置文件：applicationContext-mvc.xml  <mvc:resources mapping="/css/**" location="/css/"/>  <mvc:resources mapping="/images/**" location="/img/"/>  <mvc:resources mapping="/js/**" location="/js/"/>

使用攔截器

在實際應用中，咱們一般都是通過實現 HandlerInterceptor 介面或者繼承 HandlerInterceptorAdapter 抽象類，複寫 preHandle()、postHandle() 和 afterCompletion()這 3 個方法來對用戶的請求進行攔截處理的。

實現 HandlerInterceptor 介面（需要實現三個方法）

在 HandlerInterceptor 介面中，定義了 3 個方法，分別為 preHandle()、postHandle() 和 afterCompletion()，咱們就是通過複寫這 3 個方法來對用戶的請求進行攔截處理的。因此，咱們可以通過直接實現 HandlerInterceptor 介面來實現攔截器的功能。

public interface HandlerInterceptor {      //該方法在請求處理之前進行調用。      boolean preHandle(HttpServletRequest var1, HttpServletResponse var2, Object var3) throws Exception;      void postHandle(HttpServletRequest var1, HttpServletResponse var2, Object var3, ModelAndView var4) throws Exception;      void afterCompletion(HttpServletRequest var1, HttpServletResponse var2, Object var3, Exception var4) throws Exception;  }

preHandle(HttpServletRequest request, HttpServletResponse response, Object handle) 方法，該方法在請求處理之前進行調用。SpringMVC 中的 Interceptor 是鏈式調用的，在一個應用中或者說是在一個請求中可以同時存在多個 Interceptor 。每個 Interceptor 的調用會依據它的聲明順序依次執行，而且最先執行的都是 Interceptor 中的 preHandle 方法，所以可以在這個方法中進行一些前置初始化操作或者是對當前請求做一個預處理，也可以在這個方法中進行一些判斷來決定請求是否要繼續進行下去。該方法的返回值是布爾值 Boolean 類型的，當它返回為 false 時，表示請求結束，後續的 Interceptor 和 Controller 都不會再執行；當返回值為 true 時，就會繼續調用下一個 Interceptor 的 preHandle 方法，如果已經是最後一個 Interceptor 的時候，就會是調用當前請求的 Controller 中的方法。
postHandle(HttpServletRequest request, HttpServletResponse response, Object handle, ModelAndView modelAndView)方法，通過 preHandle 方法的解釋咱們知道這個方法包括後面要說到的 afterCompletion 方法都只能在當前所屬的 Interceptor 的 preHandle 方法的返回值為 true 的時候，才能被調用。postHandle 方法在當前請求進行處理之後，也就是在 Controller 中的方法調用之後執行，但是它會在 DispatcherServlet 進行視圖返回渲染之前被調用，所以咱們可以在這個方法中對 Controller 處理之後的 ModelAndView 對象進行操作。postHandle 方法被調用的方向跟 preHandle 是相反的，也就是說，先聲明的 Interceptor 的 postHandle 方法反而會後執行。
afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handle, Exception ex) 方法，也是需要當前對應的 Interceptor 的 preHandle 方法的返回值為 true 時才會執行。因此，該方法將在整個請求結束之後，也就是在 DispatcherServlet 渲染了對應的視圖之後執行，這個方法的主要作用是用於進行資源清理的工作。

繼承 HandlerInterceptorAdapter（一般使用此種方式）

需要哪個方法重寫即可，不需要實現所有方法

afterConcurrentHandlingStarted()方法用於處理非同步請求，當 Controller 中有非同步請求方法的時候會觸發該方法時，非同步請求先支援 preHandle、然後執行 afterConcurrentHandlingStarted。非同步執行緒完成之後執行preHandle、postHandle、afterCompletion。

public class TestHandlerInterceptorAdapter extends HandlerInterceptorAdapter {      public TestHandlerInterceptorAdapter() {          super();      }      @Override      public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {          return super.preHandle(request, response, handler);      }      @Override      public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {          super.postHandle(request, response, handler, modelAndView);      }      @Override      public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {          super.afterCompletion(request, response, handler, ex);      }      @Override      public void afterConcurrentHandlingStarted(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {          super.afterConcurrentHandlingStarted(request, response, handler);      }  }

攔截器使用測試

創建攔截器

public class LoginHandlerInterceptor implements HandlerInterceptor {        public boolean preHandle(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o) throws Exception {          System.out.println("preHandle ------- Intercepter1" );          return true;      }      public void postHandle(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o, ModelAndView modelAndView) throws Exception {          System.out.println("postHandle ------- Intercepter1");      }      public void afterCompletion(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o, Exception e) throws Exception {          System.out.println("afterCompletion ------- Intercepter1");      }

public class LoginHandlerIntercepter2 implements HandlerInterceptor {        public boolean preHandle(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o) throws Exception {          System.out.println("preHandle ------- Intercepter2" );          return true;      }        public void postHandle(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o, ModelAndView modelAndView) throws Exception {          System.out.println("postHandle ------- Intercepter2" );      }        public void afterCompletion(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o, Exception e) throws Exception {          System.out.println("afterCompletion ------- Intercepter2" );      }  }

在 spring-mvc.xml 聲明攔截器

<mvc:interceptors>       <!--使用 bean 定義一個 Interceptor，直接定義在 mvc:interceptors 下面的 Interceptor 將攔截所有的請求 -->      <bean class="com.anqi.testHandlerInterceptor.LoginHandlerInterceptor"></bean>      <mvc:interceptor>          <mvc:mapping path="/testip"/>          <!-- 定義在 mvc:interceptor 下面的 Interceptor，表示對特定的請求進行攔截 -->          <bean class="com.anqi.testHandlerInterceptor.LoginHandlerIntercepter2"></bean>      </mvc:interceptor>  </mvc:interceptors>

測試結果1（第一個攔截器的 preHandle 返回 true）

preHandle ------- Intercepter1  preHandle ------- Intercepter2  postHandle ------- Intercepter2  postHandle ------- Intercepter1  afterCompletion ------- Intercepter2  afterCompletion ------- Intercepter1  頁面上正常返回

測試結果2（第一個攔截器的 preHandle 返回 false）

preHandle ------- Intercepter1    頁面沒有返回 controller 返回的頁面

SimpleMappingExceptionResolver 攔截異常

官方文檔描述：

A mapping between exception class names and error view names. Useful for rendering error pages in a browser application.

<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">     <property name="exceptionMappings">        <props>           <prop key="java.lang.Exception">/errors/404</prop>        </props>     </property>  </bean>

<html>  <head>     <title>404</title>     <link href="${basePath}/css/system/404.css" type="text/css" rel="stylesheet">     <script type="text/javascript">     </script>  </head>  <body>     <div class="errorPage">        <div class="errorImg"></div>        <a href="${basePath}/index" class="ui-button ui-button-positive ui-button-large">返回首頁</a>     </div>  </body>  </html>