SpringMVC的處理器攔截器HandlerInterceptor詳解
簡介
SpringWebMVC的處理器攔截器，類似于Servlet開發(fā)中的過濾器Filter，用于處理器進行預(yù)處理和后處理。
應(yīng)用場景
1、日志記錄，可以記錄請求信息的日志，以便進行信息監(jiān)控、信息統(tǒng)計等。
2、權(quán)限檢查：如登陸檢測，進入處理器檢測是否登陸，如果沒有直接返回到登陸頁面。
3、性能監(jiān)控：典型的是慢日志。
HandlerInterceptor
public interface HandlerInterceptor {
/**
* 預(yù)處理回調(diào)方法，實現(xiàn)處理器的預(yù)處理（如檢查登陸），第三個參數(shù)為響應(yīng)的處理器，自定義Controller
* 返回值：true表示繼續(xù)流程（如調(diào)用下一個攔截器或處理器）；false表示流程中斷（如登錄檢查失?。?，不會繼續(xù)調(diào)用其他的攔截器或處理器，此時我們需要通過response來產(chǎn)生響應(yīng)；
*/
boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception;
/**
* 后處理回調(diào)方法，實現(xiàn)處理器的后處理（但在渲染視圖之前），此時我們可以通過modelAndView（模型和視圖對象）對模型數(shù)據(jù)進行處理或?qū)σ晥D進行處理，modelAndView也可能為null。
*/
void postHandle(
HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)
throws Exception;
/**
* 整個請求處理完畢回調(diào)方法，即在視圖渲染完畢時回調(diào)，如性能監(jiān)控中我們可以在此記錄結(jié)束時間并輸出消耗時間，還可以進行一些資源清理，類似于try-catch-finally中的finally，但僅調(diào)用處理器執(zhí)行鏈中
*/
void afterCompletion(
HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
throws Exception;
}攔截器適配器HandlerInterceptorAdapter
有時候我們可能只需要實現(xiàn)三個回調(diào)方法中的某一個，如果實現(xiàn)HandlerInterceptor接口的話，三個方法必須實現(xiàn)，不管你需不需要，此時spring提供了一個HandlerInterceptorAdapter適配器（種適配器設(shè)計模式的實現(xiàn)），允許我們只實現(xiàn)需要的回調(diào)方法。
public abstract class HandlerInterceptorAdapter implements AsyncHandlerInterceptor {
/**
* 默認(rèn)是true
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception {
return true;
}
/**
* This implementation is empty.
*/
@Override
public void postHandle(
HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)
throws Exception {
}
/**
* This implementation is empty.
*/
@Override
public void afterCompletion(
HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
throws Exception {
}
/**
* 不是HandlerInterceptor的接口實現(xiàn)，是AsyncHandlerInterceptor的，AsyncHandlerInterceptor實現(xiàn)了HandlerInterceptor
*/
@Override
public void afterConcurrentHandlingStarted(
HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception {
}
}這樣在我們業(yè)務(wù)中比如要記錄系統(tǒng)日志，日志肯定是在afterCompletion之后記錄的，否則中途失敗了，也記錄了，那就扯淡了。一定是程序正常跑完后，我們記錄下那些對數(shù)據(jù)庫做個增刪改的操作日志進數(shù)據(jù)庫。所以我們只需要繼承HandlerInterceptorAdapter，并重寫afterCompletion一個方法即可，因為preHandle默認(rèn)是true。
運行流程總結(jié)如下：
1、攔截器執(zhí)行順序是按照Spring配置文件中定義的順序而定的。
2、會先按照順序執(zhí)行所有攔截器的preHandle方法，一直遇到return false為止，比如第二個preHandle方法是return false，則第三個以及以后所有攔截器都不會執(zhí)行。若都是return true，則按順序加載完preHandle方法。
3、然后執(zhí)行主方法（自己的controller接口），若中間拋出異常，則跟return false效果一致，不會繼續(xù)執(zhí)行postHandle，只會倒序執(zhí)行afterCompletion方法。
4、在主方法執(zhí)行完業(yè)務(wù)邏輯（頁面還未渲染數(shù)據(jù)）時，按倒序執(zhí)行postHandle方法。若第三個攔截器的preHandle方法return false，則會執(zhí)行第二個和第一個的postHandle方法和afterCompletion（postHandle都執(zhí)行完才會執(zhí)行這個，也就是頁面渲染完數(shù)據(jù)后，執(zhí)行after進行清理工作）方法。（postHandle和afterCompletion都是倒序執(zhí)行）
正常流程Demo
package com.bshf.recipe.demo.syslog;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class SyslogInterceptor implements HandlerInterceptor {
/**
* 預(yù)處理回調(diào)方法，實現(xiàn)處理器的預(yù)處理（如檢查登陸），第三個參數(shù)為響應(yīng)的處理器，自定義Controller
* 返回值：true表示繼續(xù)流程（如調(diào)用下一個攔截器或處理器）；false表示流程中斷（如登錄檢查失?。?，不會繼續(xù)調(diào)用其他的攔截器或處理器，此時我們需要通過response來產(chǎn)生響應(yīng)；
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception {
System.out.println("==========================================1================================================");
return true;
}
/**
* 后處理回調(diào)方法，實現(xiàn)處理器的后處理（但在渲染視圖之前），此時我們可以通過modelAndView（模型和視圖對象）對模型數(shù)據(jù)進行處理或?qū)σ晥D進行處理，modelAndView也可能為null。
*/
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
ModelAndView modelAndView) throws Exception {
System.out.println("==========================================post1================================================");
}
/**
* 整個請求處理完畢回調(diào)方法，即在視圖渲染完畢時回調(diào)，如性能監(jiān)控中我們可以在此記錄結(jié)束時間并輸出消耗時間，還可以進行一些資源清理，類似于try-catch-finally中的finally，但僅調(diào)用處理器執(zhí)行鏈中
*/
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
throws Exception {
System.out.println("==========================================after1================================================");
}
}package com.bshf.recipe.demo.syslog;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class SyslogInterceptor2 implements HandlerInterceptor {
/**
* 預(yù)處理回調(diào)方法，實現(xiàn)處理器的預(yù)處理（如檢查登陸），第三個參數(shù)為響應(yīng)的處理器，自定義Controller
* 返回值：true表示繼續(xù)流程（如調(diào)用下一個攔截器或處理器）；false表示流程中斷（如登錄檢查失?。粫^續(xù)調(diào)用其他的攔截器或處理器，此時我們需要通過response來產(chǎn)生響應(yīng)；
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception {
System.out.println("==========================================2================================================");
return true;
}
/**
* 后處理回調(diào)方法，實現(xiàn)處理器的后處理（但在渲染視圖之前），此時我們可以通過modelAndView（模型和視圖對象）對模型數(shù)據(jù)進行處理或?qū)σ晥D進行處理，modelAndView也可能為null。
*/
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
ModelAndView modelAndView) throws Exception {
System.out.println("==========================================post2================================================");
}
/**
* 整個請求處理完畢回調(diào)方法，即在視圖渲染完畢時回調(diào)，如性能監(jiān)控中我們可以在此記錄結(jié)束時間并輸出消耗時間，還可以進行一些資源清理，類似于try-catch-finally中的finally，但僅調(diào)用處理器執(zhí)行鏈中
*/
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
throws Exception {
System.out.println("==========================================after2================================================");
}
}package com.bshf.recipe.demo.syslog;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
public class SyslogInterceptor3 implements HandlerInterceptor {
/**
* 預(yù)處理回調(diào)方法，實現(xiàn)處理器的預(yù)處理（如檢查登陸），第三個參數(shù)為響應(yīng)的處理器，自定義Controller
* 返回值：true表示繼續(xù)流程（如調(diào)用下一個攔截器或處理器）；false表示流程中斷（如登錄檢查失?。粫^續(xù)調(diào)用其他的攔截器或處理器，此時我們需要通過response來產(chǎn)生響應(yīng)；
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception {
System.out.println("==========================================3================================================");
return true;
}
/**
* 后處理回調(diào)方法，實現(xiàn)處理器的后處理（但在渲染視圖之前），此時我們可以通過modelAndView（模型和視圖對象）對模型數(shù)據(jù)進行處理或?qū)σ晥D進行處理，modelAndView也可能為null。
*/
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
ModelAndView modelAndView) throws Exception {
System.out.println("==========================================post3================================================");
}
/**
* 整個請求處理完畢回調(diào)方法，即在視圖渲染完畢時回調(diào)，如性能監(jiān)控中我們可以在此記錄結(jié)束時間并輸出消耗時間，還可以進行一些資源清理，類似于try-catch-finally中的finally，但僅調(diào)用處理器執(zhí)行鏈中
*/
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
throws Exception {
System.out.println("==========================================after3================================================");
}
}<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean class="com.bshf.recipe.demo.syslog.SyslogInterceptor" />
</mvc:interceptor>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean class="com.bshf.recipe.demo.syslog.SyslogInterceptor2" />
</mvc:interceptor>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean class="com.bshf.recipe.demo.syslog.SyslogInterceptor3" />
</mvc:interceptor>
</mvc:interceptors><mvc:mapping path="/**"/>需要攔截的路徑，這里匹配所有。這里的配置順序?qū)⑹菙r截器執(zhí)行順序。
輸出結(jié)果
==========================================1================================================
==========================================2================================================
==========================================3================================================
==========================================post3================================================
==========================================post2================================================
==========================================post1================================================
==========================================after3================================================
==========================================after2================================================
==========================================after1================================================
post和after是倒序的?。。?！
中斷流程Demo
將SyslogInterceptor3的preHandle方法返回false。其他不變，再看輸出結(jié)果
==========================================1================================================
==========================================2================================================
==========================================3================================================
==========================================after2================================================
==========================================after1================================================
發(fā)現(xiàn)沒有了post，post方法一個都沒有輸出。不僅如此，你的主程序代碼（xxx.controller的一個接口）都不會被執(zhí)行，所以只要遇到return false，則直接進行after清理工作，post和自己主程序代碼都將被略過。
到此這篇關(guān)于SpringMVC的處理器攔截器HandlerInterceptor詳解的文章就介紹到這了,更多相關(guān)攔截器HandlerInterceptor內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！
- 深入解析Spring MVC中攔截器Interceptor的實現(xiàn)原理和應(yīng)用場景
- Spring?Boot?Interceptor的原理、配置、順序控制及與Filter的關(guān)鍵區(qū)別對比分析
- SpringBoot使用Mybatis-Plus中分頁插件PaginationInterceptor詳解
- Spring Boot攔截器Interceptor與過濾器Filter深度解析(區(qū)別、實現(xiàn)與實戰(zhàn)指南)
- Spring Mvc中攔截器Interceptor用法解讀
- Spring Boot攔截器Interceptor與過濾器Filter詳細(xì)教程(示例詳解)
- Spring攔截器之HandlerInterceptor使用方式
- Spring的攔截器HandlerInterceptor詳解
- spring中Interceptor的使用小結(jié)
相關(guān)文章
這篇文章主要介紹了JAVA類變量及類方法代碼實例詳解,文中通過示例代碼介紹的非常詳細(xì)，對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友可以參考下2020-02-02
下面小編就為大家?guī)硪黄贘ava子線程中的異常處理方法(通用)。小編覺得挺不錯的，現(xiàn)在就分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2017-09-09
這篇文章主要介紹了Java-Jackson使用詳解,本文給大家介紹的非常詳細(xì)，對大家的學(xué)習(xí)或工作具有一定的參考借鑒價值，需要的朋友可以參考下2021-03-03
這篇文章主要介紹了控制臺顯示java冒泡排序流程示例,需要的朋友可以參考下2014-03-03
本文詳細(xì)介紹了SpringWebFlux的使用,包括構(gòu)建ReactiveRESTAPI、響應(yīng)式數(shù)據(jù)庫訪問（R2DBC）和WebSocket實時通信,通過這些功能,開發(fā)者可以構(gòu)建高性能、可擴展的響應(yīng)式Web應(yīng)用,感興趣的朋友跟隨小編一起看看吧2026-01-01
這篇文章主要介紹了詳解Spring Boot2 Webflux的全局異常處理，小編覺得挺不錯的，現(xiàn)在分享給大家，也給大家做個參考。一起跟隨小編過來看看吧2018-12-12
本文詳細(xì)介紹了JAVA冒泡排序和二分查找的實現(xiàn)，雖然這兩種算法比較簡單，但是確實我們必須需要掌握的。下面來看看。2016-07-07
基于 Cursor 開發(fā) Spring Boot 項目詳細(xì)攻略
Cursor是集成GPT4、Claude3.5等LLM的VSCode類AI編程工具,支持SpringBoot項目開發(fā)全流程,涵蓋環(huán)境配置、代碼生成、數(shù)據(jù)庫連接及部署,提供智能輔助、代碼優(yōu)化與錯誤修復(fù)功能,助力高效開發(fā),本文給大家介紹基于Cursor開發(fā)Spring Boot項目詳細(xì)攻略,感興趣的朋友一起看看吧2025-09-09
java中break和continue區(qū)別及使用場合分析
本文力圖通過實例加使用場合詳解來引導(dǎo)菜鳥重新認(rèn)識break和continue語句,需要的朋友可以參考下2014-01-01
Shiro @RequiresPermissions不生效原因及解決方案
Shiro@rio@RequiresPermissions不生效的原因分析,包括AOP配置和權(quán)限寫寫法錯誤,幫助開發(fā)者正確配置AOP依賴和理解權(quán)限寫法,以確保權(quán)限檢查功能正常運行2026-05-05