SpringBoot過濾器與攔截器深入分析實(shí)現(xiàn)方法

更新時(shí)間：2022年11月04日 10:00:42 作者：twilight0402

大家應(yīng)該都曉得實(shí)現(xiàn)過濾器需要實(shí)現(xiàn) javax.servlet.Filter 接口，而攔截器會在處理指定請求之前和之后進(jìn)行相關(guān)操作，配置攔截器需要兩步，本文通過實(shí)例代碼給大家介紹SpringBoot 過濾器和攔截器的相關(guān)知識，感興趣的朋友一起看看吧

過濾器

實(shí)現(xiàn)過濾器需要實(shí)現(xiàn) javax.servlet.Filter 接口。重寫三個(gè)方法。其中 init() 方法在服務(wù)啟動(dòng)時(shí)執(zhí)行，destroy() 在服務(wù)停止之前執(zhí)行。

可用兩種方式注冊過濾器：

使用 FilterRegistrationBean 來注入?？墒褂?setOrder(0) 設(shè)置過濾器的優(yōu)先級，越小優(yōu)先級越高。
使用 @WebFilter(filterName = "myFilter2" ,urlPatterns = "/*") 配合 @ServletComponentScan() 實(shí)現(xiàn)注入。（@Order 注解無效）

編寫過濾器

package com.example.recorddemo.filters;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
public class MyFilter1 implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        System.out.println("初始化過濾器：" + filterConfig.getFilterName());
    }
    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
        System.out.println("在請求之前做處理");
        if (servletRequest instanceof HttpServletRequest) {
            System.out.println("  URL:" + ((HttpServletRequest)servletRequest).getRequestURL());
        }
        // 調(diào)用filter鏈中的下一個(gè)filter
        filterChain.doFilter(servletRequest, servletResponse);
        System.out.println("在請求之后做處理");
    }
    @Override
    public void destroy() {
        System.out.println("銷毀：MyFilter1");
    }
}

注冊過濾器

基于 FilterRegistrationBean

在配置類中注冊一個(gè) FilterRegistrationBean 類型的Bean。

如果沒有設(shè)置 UrlPatterns ，那么會自動(dòng)關(guān)聯(lián)到 /* 上。
如果沒有設(shè)置過濾器的名字，那么會自動(dòng)推理出一個(gè)過濾器名稱（bean的名字）

When no URL pattern or servlets are specified the filter will be associated to ‘/*’. The filter name will be deduced if not specified.

fileter默認(rèn)是enable的，將其設(shè)置為false表示關(guān)閉當(dāng)前過濾器。
可通過 setOrder(0) 方法設(shè)置過濾器的優(yōu)先級，如果優(yōu)先級相同，則先定義的優(yōu)先級更高。

@Configuration
public class FilterConfiguration {
    @Bean
    public FilterRegistrationBean myFilter1(){
        MyFilter1 filter = new MyFilter1();
        FilterRegistrationBean filterRegistrationBean = new FilterRegistrationBean(filter);
//        filterRegistrationBean.addUrlPatterns("/*");
//        filterRegistrationBean.setEnabled(true);
        return filterRegistrationBean;
    }
}

基于 @WebFilter

使用 @WebFilter 修飾filter。
在任意configuration類中添加 @ServletComponentScan("com.example.recorddemo.filters")，包名可以不填。

import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;
@WebFilter(filterName = "myFilter2" ,urlPatterns = "/*")
public class MyFilter2 implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {}
    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
        // 調(diào)用filter鏈中的下一個(gè)filter
        filterChain.doFilter(servletRequest, servletResponse);
    }
    @Override
    public void destroy() {}
}

攔截器

攔截器會在處理指定請求之前和之后進(jìn)行相關(guān)操作，配置攔截器需要兩步

編寫攔截器類（實(shí)現(xiàn) HandlerInterceptor 接口）
添加已實(shí)現(xiàn)的攔截器（實(shí)現(xiàn) WebMvcConfigurer 接口，并重寫 addInterceptors() 方法）
添加addPathPatterns()規(guī)定攔截哪些請求。（/*表示只攔截/下的所有目錄，但是不包括子目錄, /**表示攔截/下的所有目錄，及其子目錄）

攔截器類：

package com.example.recorddemo.interceptor;
import org.springframework.stereotype.Component;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
 * @author wangchao
 */
@Component
public class MyInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        // handle可拿到執(zhí)行方法的反射對象。
        System.out.println("preHandle: MyInterceptor");
        return true;
    }
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        // 對于RESTful 接口用處不大
    }
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        // 可捕捉異常，但是springboot已經(jīng)有了全局異常捕捉
    }
}

配置攔截器：

package com.example.recorddemo.configuration;
import com.example.recorddemo.interceptor.MyInterceptor;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.config.annotation.InterceptorRegistration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;
import javax.annotation.Resource;
@Configuration
public class InterceptorConfiguration implements WebMvcConfigurer {
    @Resource
    MyInterceptor myInterceptor;
    /**
     * 添加攔截器
     * @param registry
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(myInterceptor).addPathPatterns("/**");
    }
}

registry.addInterceptor() 方法會返回當(dāng)前的 interceptor，因此可直接執(zhí)行 addPathPatterns() 方法

    public InterceptorRegistration addInterceptor(HandlerInterceptor interceptor) {
        InterceptorRegistration registration = new InterceptorRegistration(interceptor);
        this.registrations.add(registration);
        return registration;
    }

攔截器的執(zhí)行順序類似于棧，按照如下順序執(zhí)行：