腳本之家服務(wù)器常用軟件

快捷導(dǎo)航

Spring Boot攔截器Interceptor與過濾器Filter詳細教程(示例詳解)

更新時間：2025年03月17日 14:44:14 作者：蹦跑的蝸牛

本文詳細介紹了SpringBoot中的攔截器（Interceptor）和過濾器（Filter）,包括它們的定義、作用范圍、使用場景、實現(xiàn)步驟、執(zhí)行順序、常見問題及解決方案,感興趣的朋友跟隨小編一起看看吧

Spring Boot攔截器（Interceptor）與過濾器（Filter）詳細教程

1. 概述

1.1 什么是攔截器（Interceptor）？

攔截器是 Spring MVC 框架的組件，基于 AOP（面向切面編程） 實現(xiàn)。它允許在請求處理的不同階段（如Controller方法執(zhí)行前后）插入自定義邏輯。

1.2 什么是過濾器（Filter）？

過濾器是 Java Servlet規(guī)范 定義的組件，作用于所有進入容器的請求（如Tomcat）。它可以在請求到達Servlet前或響應(yīng)返回客戶端前進行預(yù)處理和后處理。

1.3 核心區(qū)別

特性	攔截器（Interceptor）	過濾器（Filter）
所屬框架	Spring MVC	Servlet API
作用范圍	僅Spring MVC管理的請求	所有請求（包括靜態(tài)資源）
依賴	依賴Spring容器	依賴Servlet容器（如Tomcat）
執(zhí)行時機	Controller方法前后	Servlet處理前后
獲取Bean	支持（通過Spring上下文）	不支持（需通過其他方式注入）

2. 使用場景

2.1 攔截器的典型應(yīng)用

日志記錄：記錄請求參數(shù)、響應(yīng)時間。
權(quán)限驗證：檢查用戶是否登錄或擁有權(quán)限。
事務(wù)管理：在Controller方法前后開啟/提交事務(wù)。
性能監(jiān)控：統(tǒng)計接口耗時。

2.2 過濾器的典型應(yīng)用

全局字符編碼：統(tǒng)一設(shè)置請求/響應(yīng)的編碼（如UTF-8）。
跨域處理：添加CORS響應(yīng)頭。
XSS防御：過濾請求參數(shù)中的惡意腳本。
請求壓縮：對響應(yīng)內(nèi)容進行GZIP壓縮。

3. 實現(xiàn)步驟

3.1 創(chuàng)建攔截器

步驟：

實現(xiàn) HandlerInterceptor 接口，重寫以下方法：

preHandle()：在Controller方法執(zhí)行前調(diào)用。
postHandle()：在Controller方法執(zhí)行后、視圖渲染前調(diào)用。
afterCompletion()：在請求完成后調(diào)用（視圖渲染后）。

注冊攔截器到Spring MVC配置。

代碼示例：

public class AuthInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) {
        // 檢查用戶是否登錄
        if (request.getSession().getAttribute("user") == null) {
            response.sendRedirect("/login");
            return false; // 中斷請求
        }
        return true;
    }
}

注冊攔截器：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new AuthInterceptor())
                .addPathPatterns("/**")
                .excludePathPatterns("/login", "/static/**");
    }
}

注冊多個攔截器：

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 第一個攔截器：日志（優(yōu)先級高）
        registry.addInterceptor(new LogInterceptor())
                .addPathPatterns("/**")       // 攔截所有路徑
                .excludePathPatterns("/static/**"); // 排除靜態(tài)資源
        // 第二個攔截器：權(quán)限（優(yōu)先級低）
        registry.addInterceptor(new AuthInterceptor())
                .addPathPatterns("/api/**");  // 僅攔截/api路徑
    }
}

關(guān)鍵配置選項

配置方法	說明
`addPathPatterns("/api")`	指定攔截的路徑（支持Ant風(fēng)格）
`excludePathPatterns("/login")`	排除特定路徑
`order(1)`	顯式設(shè)置順序（默認按注冊順序）

若要手動指定順序，可添加：

registry.addInterceptor(new LogInterceptor()).order(1);
registry.addInterceptor(new AuthInterceptor()).order(2);

3.2 創(chuàng)建過濾器

步驟：

實現(xiàn) javax.servlet.Filter 接口，重寫 doFilter 方法。
注冊過濾器到Servlet容器（通過注解或配置類）。

代碼示例：

@WebFilter(urlPatterns = "/*")
public class LoggingFilter implements Filter {
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) 
            throws IOException, ServletException {
        System.out.println("請求開始: " + ((HttpServletRequest) request).getRequestURI());
        chain.doFilter(request, response); // 繼續(xù)執(zhí)行后續(xù)過濾器或Servlet
        System.out.println("請求結(jié)束");
    }
}

注冊過濾器（若未使用@WebFilter）：

@Configuration
public class FilterConfig {
    @Bean
    public FilterRegistrationBean<LoggingFilter> loggingFilter() {
        FilterRegistrationBean<LoggingFilter> bean = new FilterRegistrationBean<>();
        bean.setFilter(new LoggingFilter());
        bean.addUrlPatterns("/*");
        bean.setOrder(1); // 設(shè)置執(zhí)行順序
        return bean;
    }
}

注意： 確保主類添加 @ServletComponentScan 以啟用 @WebFilter 注解。

4. 執(zhí)行順序與流程

4.1 執(zhí)行順序

過濾器（FilterChain） → 2. 攔截器（preHandle） → 3. Controller方法 → 4. 攔截器（postHandle） → 5. 視圖渲染 → 6. 攔截器（afterCompletion） → 7. 過濾器后續(xù)處理

4.2 流程圖

客戶端 → Filter.doFilter() → Interceptor.preHandle()
       → Controller → Interceptor.postHandle()
       → 視圖渲染 → Interceptor.afterCompletion()
       → Filter.doFilter()后續(xù)處理 → 客戶端

5. 常見問題與解決方案

Q1：如何控制多個攔截器/過濾器的執(zhí)行順序？

攔截器：通過 registry.addInterceptor() 的順序決定。
過濾器：通過 FilterRegistrationBean.setOrder() 設(shè)置優(yōu)先級（值越小越先執(zhí)行）。

Q2：攔截器中如何獲取Spring管理的Bean？

直接從Spring容器注入：

public class AuthInterceptor implements HandlerInterceptor {
    @Autowired
    private UserService userService; // 直接注入
}

Q3：過濾器中如何修改請求參數(shù)？

通過自定義 HttpServletRequestWrapper：

public class ModifyRequestWrapper extends HttpServletRequestWrapper {
    // 重寫getParameter等方法以修改參數(shù)
}
// 在Filter中替換Request對象
chain.doFilter(new ModifyRequestWrapper(request), response);

Q4：攔截器和過濾器執(zhí)行時出現(xiàn)異常如何處理？

攔截器：在 afterCompletion 中處理異常。
過濾器：使用 try-catch 包裹 chain.doFilter()。

Q5：如何讓某個攔截器全局生效？

使用 addPathPatterns("/**")：

registry.addInterceptor(new LogInterceptor())
        .addPathPatterns("/**");

Q6：如何跳過特定攔截器的執(zhí)行？

在 preHandle 中返回 false：

@Override
public boolean preHandle(...) {
    if (跳過條件) {
        return false; // 后續(xù)攔截器和Controller不會執(zhí)行
    }
    return true;
}

Q7：攔截器之間如何共享數(shù)據(jù)？

通過 request.setAttribute 傳遞：

// 在第一個攔截器中存儲數(shù)據(jù)
request.setAttribute("key", "value");
// 在后續(xù)攔截器中獲取
String value = (String) request.getAttribute("key");

6. 總結(jié)

選擇攔截器還是過濾器？

需要訪問Spring上下文或Controller信息 → 攔截器。
需處理所有請求（包括靜態(tài)資源） → 過濾器。

最佳實踐：

優(yōu)先使用攔截器處理業(yè)務(wù)相關(guān)邏輯。
使用過濾器處理底層Servlet容器的任務(wù)（如編碼、壓縮）。

到此這篇關(guān)于Spring Boot攔截器（Interceptor）與過濾器（Filter）詳細教程的文章就介紹到這了,更多相關(guān)Spring Boot攔截器與過濾器內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章:

亚洲乱码中文字幕综合,中国熟女仑乱hd,亚洲精品乱拍国产一区二区三区,一本大道卡一卡二卡三乱码全集资源,又粗又黄又硬又爽的免费视频

Spring Boot攔截器Interceptor與過濾器Filter詳細教程(示例詳解)

目錄

Spring Boot攔截器（Interceptor）與過濾器（Filter）詳細教程

1. 概述

1.1 什么是攔截器（Interceptor）？

1.2 什么是過濾器（Filter）？

1.3 核心區(qū)別

2. 使用場景

2.1 攔截器的典型應(yīng)用

2.2 過濾器的典型應(yīng)用

3. 實現(xiàn)步驟

3.1 創(chuàng)建攔截器

3.2 創(chuàng)建過濾器

4. 執(zhí)行順序與流程

4.1 執(zhí)行順序

4.2 流程圖

5. 常見問題與解決方案

6. 總結(jié)

相關(guān)文章

最新評論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具

亚洲乱码中文字幕综合,中国熟女仑乱hd,亚洲精品乱拍国产一区二区三区,一本大道卡一卡二卡三乱码全集资源,又粗又黄又硬又爽的免费视频

Spring Boot攔截器Interceptor與過濾器Filter詳細教程(示例詳解)

目錄

Spring Boot攔截器（Interceptor）與過濾器（Filter）詳細教程

1. 概述

1.1 什么是攔截器（Interceptor）？

1.2 什么是過濾器（Filter）？

1.3 核心區(qū)別

2. 使用場景

2.1 攔截器的典型應(yīng)用

2.2 過濾器的典型應(yīng)用

3. 實現(xiàn)步驟

3.1 創(chuàng)建攔截器

3.2 創(chuàng)建過濾器

4. 執(zhí)行順序與流程

4.1 執(zhí)行順序

4.2 流程圖

5. 常見問題與解決方案

6. 總結(jié)

相關(guān)文章

最新評論

大家感興趣的內(nèi)容

最近更新的內(nèi)容

常用在線小工具

1.1 什么是攔截器（Interceptor）？