SpringMVC一步到位精通攔截器

更新時間：2022年12月23日 11:27:37 作者：Hhzzy99

攔截器（Interceptor）是一種動態(tài)攔截方法調用的機制，在SpringMVC中動態(tài)攔截控制器方法的執(zhí)行。本文將詳細講講SpringMVC中攔截器的概念及入門案例，感興趣的可以嘗試一下

前言

在上一篇文章中講完了SpringMVC的大部分知識，此篇文章中主要講解攔截器。上一篇文章??

攔截器的使用是非常普遍的。例如在 OA系統(tǒng)中通過攔截器可以攔截未登錄的用戶，或者使用它來驗證己登錄用戶是否有相應的操作權限等。SpringMVC 中提供了攔截器功能，通過配置即可對請求進行攔截處理。

攔截器概述

SpringMVC 中的攔截器 (Interceptor）類似于 Servlet 中的過濾器（Filter），它主要用于攔截用戶請求并做相應的處理。例如通過攔截器可以進行權限驗證、判斷用戶是否己登錄等。

攔截器的定義

要使用SpringMVC中的攔截器，就需要對攔截器類進行定義和配置。通常攔截器類可以通過兩種方式來定義：

一種是通過實現(xiàn) HandlerInterceptor 接口或者繼承 HandlerInterceptor 接口的實現(xiàn)類（如 HandlerInterceptorAdapter）來定義。
另一種是通過實現(xiàn) WebRequestInterceptor 接口或繼承 WebRequestInterceptor 接口的實現(xiàn)類來定義。

實現(xiàn)HandlerInterceptor接口的定義方式為例，自定義攔截器類的代碼如下所示：

public class UserInterceptor implements HandlerInterceptor {
    public boolean preHandle(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Object handler) throws Exception {
        System.out.println("UserInterceptor...preHandle");
        //對攔截的請求進行放行處理(true為放行，false為不放行)
        return true;
    }
    public void postHandle(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("UserInterceptor...postHandle");
    }
    public void afterCompletion(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("UserInterceptor...afterCompletion");
    }
}

從上述代碼可以看出，自定義的攔截器類實現(xiàn)了 HandlerInterceptor 接口，并實現(xiàn)了接口中的3 個方法。關于這3個方法的具體描述如下：

preHandle()方法：該方法會在控制器方法前執(zhí)行，其返回值表示是否中斷后續(xù)操作。當其返回值為true 時，表示繼續(xù)向下執(zhí)行；當其返回值為false 時，會中斷后續(xù)的所有操作（包括調用下一個攔截器和控制器類中的方法執(zhí)行等）。
postHandle()方法：該方法會在控制器方法調用之后，且解析視圖之前執(zhí)行?？梢酝ㄟ^此方法對請求域中的模型和視圖做出進一步的修改。
afterCompletion()方法：該方法在整個請求完成，即視圖渲染結束之后執(zhí)行。可以通過此方法實現(xiàn)一些資源清理、記錄日志信息等工作。

攔截器的配置

要使自定義的攔截器類生效，需要在SpringMVC的配置文件中進行配置，配置代碼如下：

<!--配置攔截器-->
    <mvc:interceptors>
        <!--使用bean直接定義在<mvc:interceptor>下面的Interceptor 將攔截所有請求-->
        <bean class="com.hzy.interceptor.UserInterceptor"/>
        <!--攔截器1-->
        <mvc:interceptor>
            <!--配置攔截器作用的路徑-->
            <mvc:mapping path="/**"/>
            <!--配置不需要攔截器作用的路徑-->
            <mvc:exclude-mapping path=""/>
            <!--定義在<mvc:interceptor>下面，表示對匹配路徑的請求才進行攔截-->
            <bean class="com.hzy.interceptor.Interceptor1"/>
        </mvc:interceptor>
        <!--攔截器2-->
        <mvc:interceptor>
            <mvc:mapping path="/hello"/>
            <bean class="com.hzy.interceptor.Interceptor2"/>
        </mvc:interceptor>
            ......
    </mvc:interceptors>

在上述代碼中， <mvc:interceptors>元素用于配置一組攔截器，其子元素<bean>中定義的是全局攔截器，它會攔截所有的請求；而<mvc:interceptor>元素中定義的是指定路徑的攔截器，它會對指定路徑下的請求生效。＜mvc:interceptor>元素的子元素<mvc:mapping>用于配置攔截器作用的路徑，該路徑在其屬性 path 中定義。如上述代碼中 path 的屬性值 “/**”表示攔截所有路徑， “/hello”表示攔截所有以“hello”結尾的路徑。如果在請求路徑中包含不需要攔截的內(nèi)容，還可以通過 <mvc:exclude-mapping>元素進行配置。

攔截器的執(zhí)行流程

攔截器的執(zhí)行是有一定順序的，該順序與配置文件中所定義的攔截器的順序相關。

單個攔截器的執(zhí)行流程

如果在項目中只定義了一個攔截器，那么該攔截器在程序中的執(zhí)行流程如下圖所示。從中可以看出，程序首先會執(zhí)行攔截器類中的 preHandle()方法，如果該方法的返回值為 true，則程序就會繼續(xù)向下執(zhí)行處理器中的方法，否則將不再向下執(zhí)行：在業(yè)務處理器(即控制器Controller 類）處理完請求后，會執(zhí)行 postHandle()方法，然后通過 DispatcherServlet 向客戶端返回響應；在 DispatcherServlet 處理完請求后，才會執(zhí)行 afterCompletion()方法。

簡單的案例

web.xml中配置SpringMVC的前端過濾器和初始化加載配置文件等信息。

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
         version="3.1">
    <servlet>
        <!--配置前端過濾器-->
        <servlet-name>spring-mvc</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!--初始化時加載配置文件-->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc-config.xml</param-value>
        </init-param>
        <!--表示容器在啟動時立即加載Servlet-->
        <load-on-startup>1</load-on-startup>
    </servlet>
    <servlet-mapping>
        <servlet-name>spring-mvc</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
</web-app>

在src下創(chuàng)建com.hzy.controller包，并在里面創(chuàng)建控制器類HelloController,

@Controller
public class HelloController {
    @RequestMapping("/hello")
    public String hello(){
        System.out.println("Hello");
        return "success";
    }
}

在src下創(chuàng)建com.hzy.interceptor包，并在里面創(chuàng)建攔截器類UserInterceptor，該類需要實現(xiàn)HandlerInterceptor接口。

public class UserInterceptor implements HandlerInterceptor {
    public boolean preHandle(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Object handler) throws Exception {
        System.out.println("UserInterceptor...preHandle");
        //對攔截的請求進行放行處理(true為放行，false為不放行)
        return true;
    }
    public void postHandle(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("UserInterceptor...postHandle");
    }
    public void afterCompletion(javax.servlet.http.HttpServletRequest request, javax.servlet.http.HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("UserInterceptor...afterCompletion");
    }
}

在resources目錄下創(chuàng)建springmvc-config.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/context
       https://www.springframework.org/schema/context/spring-context.xsd
       http://www.springframework.org/schema/mvc
       https://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <!--指定需要掃描的包-->
    <context:component-scan base-package="com.hzy.controller"/>
    <!--定義視圖解析器-->
    <bean id="internalResourceViewResolve"
          class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!--設置前綴-->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!--設置后綴-->
        <property name="suffix" value=".jsp"/>
    </bean>
    <mvc:annotation-driven/>
    <!--配置攔截器-->
    <mvc:interceptors>
        <!--使用bean直接定義在<mvc:interceptor>下面的Interceptor 將攔截所有請求-->
        <bean class="com.hzy.interceptor.UserInterceptor"/>
    </mvc:interceptors>
</beans>

在WEB-INF目錄下創(chuàng)建一個jsp文件夾，并在里面創(chuàng)建一個頁面文件success.jsp，然后在<body>里面顯示任意信息。發(fā)布并啟動項目，訪問http://localhost:8080/springMvc_SSM/hello (注意你的訪問路徑可能和我不一樣哦)

結果：

控制臺

多個攔截器的執(zhí)行流程

在大型項目中，通常會定義很多攔截器來實現(xiàn)不同的功能。多個攔截器的執(zhí)行順序如圖所示。這里假設有兩個攔截器 Interceptor1和 Interceptor2，并且在配置文件中，Interceptor1攔截器配置在前。

從圖上可以看出，當有多個攔截器同時工作時，它們的preHandle()方法會按照配置文件中攔截器的配置順序執(zhí)行，而它們的postHandle()方法和afterCompletion()方法則會按照配置順序的反序執(zhí)行。

下為了驗證上述描述，下面就修改上面的代碼來演示多個攔截器的執(zhí)行。

在com.hzy.interceptor包中創(chuàng)建兩個攔截器類Interceptor1和Interceptor2。

Interceptor1.java

public class Interceptor1 implements HandlerInterceptor {
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("Interceptor1...preHandle");
        return true;
    }
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("Interceptor1...postHandle");
    }
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("Interceptor1...afterCompletion");
    }
}

Interceptor2.java

public class Interceptor2 implements HandlerInterceptor {
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("Interceptor2...preHandle");
        return true;
    }
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("Interceptor2...postHandle");
    }
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("Interceptor2...afterCompletion");
    }
}

springmvc-config.xml

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:context="http://www.springframework.org/schema/context"
       xsi:schemaLocation="http://www.springframework.org/schema/beans
       http://www.springframework.org/schema/beans/spring-beans.xsd
       http://www.springframework.org/schema/context
       https://www.springframework.org/schema/context/spring-context.xsd
       http://www.springframework.org/schema/mvc
       https://www.springframework.org/schema/mvc/spring-mvc.xsd">
    <!--指定需要掃描的包-->
    <context:component-scan base-package="com.hzy.controller"/>
    <!--定義視圖解析器-->
    <bean id="internalResourceViewResolve"
          class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <!--設置前綴-->
        <property name="prefix" value="/WEB-INF/jsp/"/>
        <!--設置后綴-->
        <property name="suffix" value=".jsp"/>
    </bean>
    <mvc:annotation-driven/>
    <!--配置攔截器-->
    <mvc:interceptors>
        <!--使用bean直接定義在<mvc:interceptor>下面的Interceptor 將攔截所有請求-->
        <bean class="com.hzy.interceptor.UserInterceptor"/>
        <!--攔截器1-->
        <mvc:interceptor>
            <!--配置攔截器作用的路徑-->
            <mvc:mapping path="/**"/>
            <!--配置不需要攔截器作用的路徑-->
<!--            <mvc:exclude-mapping path=""/>-->
            <!--定義在<mvc:interceptor>下面，表示對匹配路徑的請求才進行攔截-->
            <bean class="com.hzy.interceptor.Interceptor1"/>
        </mvc:interceptor>
        <!--攔截器2-->
        <mvc:interceptor>
            <mvc:mapping path="/hello"/>
            <bean class="com.hzy.interceptor.Interceptor2"/>
        </mvc:interceptor>
    </mvc:interceptors>
</beans>

上述攔截器的配置代碼中，第一個攔截器會作用于所有路徑下的請求，而第二個攔截器會作用于“/hello”結尾的請求。運行項目得到結果：

頁面輸出跟前面一樣。

控制臺輸出：

從圖中可以看出，程序先執(zhí)行了前面兩個攔截器類中的preHandle()方法，這兩個方法的執(zhí)行順序與配置文件中定義的順序相同；然后執(zhí)行了控制器中類中的hello()方法；最后執(zhí)行了兩個攔截器類中的postHandle()方法和afterCompletion()方法，且這兩個方法的執(zhí)行順序與配置文件中所定義的攔截器順序相反。

到此這篇關于SpringMVC一步到位精通攔截器的文章就介紹到這了,更多相關SpringMVC攔截器內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

Springboot整合FreeMarker的實現(xiàn)示例
本文主要介紹了Springboot整合FreeMarker的實現(xiàn)示例，文中通過示例代碼介紹的非常詳細，具有一定的參考價值，感興趣的小伙伴們可以參考一下
2022-02-02
Javaweb EL自定義函數(shù)開發(fā)及代碼實例
這篇文章主要介紹了Javaweb EL自定義函數(shù)開發(fā)及代碼實例,文中通過示例代碼介紹的非常詳細，對大家的學習或者工作具有一定的參考學習價值,需要的朋友可以參考下
2020-06-06
java代碼獲取jenkins數(shù)據(jù),構建歷史等信息方式
這篇文章主要介紹了java代碼獲取jenkins數(shù)據(jù),構建歷史等信息方式，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧
2020-05-05
Spring中的依賴注入DI源碼詳細解析
這篇文章主要介紹了Spring中的依賴注入DI源碼詳細解析,Spring的依賴注入(Dependency Injection,DI)是Spring框架核心的一部分,它是實現(xiàn)控制反轉(Inversion of Control,IoC)的一種方式,需要的朋友可以參考下
2023-11-11
Spring MVC 文件、cookies的接收與REST響應詳
在SpringMVC中,使用@RequestPart注解可接收文件并處理多部分請求,同時可以通過@CookieValue和HttpServletResponse來獲取和設置Cookies,本文介紹Spring MVC 文件、cookies的接收與REST響應,感興趣的朋友跟隨小編一起看看吧
2024-09-09
淺談Java程序運行機制及錯誤分析
這篇文章主要主要介紹了Java虛擬機（JVM）的有關內(nèi)容以及Java程序的運行機制和錯誤分析，需要的朋友可以了解下。
2017-09-09
java實現(xiàn)把一個List集合拆分成多個的操作
這篇文章主要介紹了java實現(xiàn)把一個List集合拆分成多個的操作，具有很好的參考價值，希望對大家有所幫助。一起跟隨小編過來看看吧
2020-08-08
Java集合之Set接口及其實現(xiàn)類精解
set接口是繼承自Collection的子接口，特點是元素不重復，存儲無序。在set接口的實現(xiàn)類中添加重復元素是不會成功的，判斷兩個元素是否重復根據(jù)元素類重寫的
2021-09-09
IDEA配置tomcat服務器全過程
這篇文章主要介紹了IDEA配置tomcat服務器全過程,具有很好的參考價值,希望對大家有所幫助,如有錯誤或未考慮完全的地方,望不吝賜教
2023-11-11
利用JStack排查死鎖問題和CPU100%問題
無論是再面試過程中還是再實際項目開發(fā)當中我們都有可能遇到這兩個問題如何利用JStack排查死鎖問題和CPU100%問題,文中給出了詳細的排查過程和解決方法,需要的朋友可以參考下
2023-12-12