一、Interceptor 的核心概念

Interceptor（攔截器） 是 Spring MVC 提供的一種機(jī)制，用于在請求處理的不同階段插入自定義邏輯。其核心作用包括：

• 預(yù)處理：在控制器方法執(zhí)行前進(jìn)行權(quán)限校驗(yàn)、日志記錄等。
• 后處理：在控制器方法執(zhí)行后修改響應(yīng)數(shù)據(jù)或記錄結(jié)果。
• 資源清理：在整個(gè)請求完成后釋放資源或處理異常。

與 Filter 的區(qū)別：

二、Interceptor 的創(chuàng)建與配置

1. 實(shí)現(xiàn)攔截器類
   繼承 HandlerInterceptor 接口，重寫以下方法：

public class AuthInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        // 請求前處理（如權(quán)限校驗(yàn)）
        return true; // 返回 false 中斷請求
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) {
        // 控制器執(zhí)行后、視圖渲染前處理（如修改 Model 數(shù)據(jù)）
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        // 請求完成后處理（如資源清理）
    }
}

2. 注冊攔截器
   通過 WebMvcConfigurer 的 addInterceptors 方法配置：

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new AuthInterceptor())
                .addPathPatterns("/api/**")     // 攔截路徑
                .excludePathPatterns("/login"); // 排除路徑
    }
}

• 路徑匹配規(guī)則：支持 Ant 風(fēng)格（如 /user/* 匹配單層路徑，/admin/** 匹配多級(jí)路徑）。
• 多攔截器順序：通過 Order 注解或?qū)崿F(xiàn) Ordered 接口控制優(yōu)先級(jí)，值越小優(yōu)先級(jí)越高。

三、攔截器的執(zhí)行順序

假設(shè)注冊了 Interceptor1 和 Interceptor2：

1. preHandle 方法：按注冊順序執(zhí)行（Interceptor1 → Interceptor2）。
2. postHandle 方法：按注冊逆序執(zhí)行（Interceptor2 → Interceptor1）。
3. afterCompletion 方法：按注冊逆序執(zhí)行（Interceptor2 → Interceptor1）。

中斷場景：若某一攔截器的 preHandle 返回 false，后續(xù)攔截器和控制器均不執(zhí)行，但已通過 preHandle 的攔截器的 afterCompletion 仍會(huì)執(zhí)行。

四、典型應(yīng)用場景

1. 權(quán)限校驗(yàn)
   在 preHandle 中檢查用戶登錄狀態(tài)或角色權(quán)限，拒絕非法請求。

   if (request.getSession().getAttribute("user") == null) {
       response.sendRedirect("/login");
       return false;
   }
   

2. 日志記錄
   記錄請求路徑、參數(shù)、耗時(shí)等信息：

   long startTime = System.currentTimeMillis();
   request.setAttribute("startTime", startTime);
   // 在 afterCompletion 中計(jì)算耗時(shí)
   

3. 性能監(jiān)控
   統(tǒng)計(jì)接口響應(yīng)時(shí)間，優(yōu)化慢請求。

4. 數(shù)據(jù)預(yù)處理
   在 postHandle 中統(tǒng)一添加響應(yīng)頭或加密敏感數(shù)據(jù)。

五、注意事項(xiàng)與最佳實(shí)踐

性能優(yōu)化

• 避免在攔截器中執(zhí)行耗時(shí)操作（如遠(yuǎn)程調(diào)用）。
• 合理設(shè)置攔截路徑，減少不必要的攔截。

常見問題排查

• 攔截器未生效：檢查路徑匹配規(guī)則、是否注冊到 Spring 容器。
• 順序混亂：通過 @Order 明確優(yōu)先級(jí)。

與 AOP 結(jié)合

• 攔截器適用于請求生命周期中的橫切邏輯，而 AOP 更適用于方法級(jí)別的切面（如事務(wù)管理）。

六、完整示例

1. 日志攔截器

public class LogInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        System.out.println("請求開始: " + request.getRequestURI());
        return true;
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
        System.out.println("請求完成: " + request.getRequestURI());
    }
}

2. 配置類

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new LogInterceptor()).addPathPatterns("/**");
        registry.addInterceptor(new AuthInterceptor())
                .addPathPatterns("/admin/**")
                .order(1); // 高優(yōu)先級(jí)
    }
}

總結(jié)

Spring Interceptor 是處理請求生命周期橫切邏輯的利器，通過靈活配置路徑和優(yōu)先級(jí)，可實(shí)現(xiàn)權(quán)限控制、日志記錄等通用功能。結(jié)合 preHandle、postHandle 和 afterCompletion 的分階段處理，能有效提升代碼復(fù)用性和可維護(hù)性。

到此這篇關(guān)于spring中Interceptor的使用小結(jié)的文章就介紹到這了,更多相關(guān)spring Interceptor使用內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

最新評(píng)論