1. 程式人生 > 其它 >SpringBoot配置過濾器的方式

SpringBoot配置過濾器的方式

在Spring中,過濾器是配置宣告在web.xml檔案中的,所有的過濾器在web.xml(web容器的配置檔案)中定義,springboot中,web.xml檔案消失。各種配置被Java類取代。@Configuration註解標記配置類,代替xml配置檔案。

filter的配置也不用在web.xml中。

1. 過濾器簡介

1. 過濾器是什麼?

Filter也稱之為過濾器,過濾器是對資料進行過濾,預處理。開發人員可以對客戶端提交的資料進行過濾處理,比如敏感詞,也可以對服務端返回的資料進行處理。還有就是可以驗證使用者的登入情況,許可權驗證,對靜態資源進行訪問控制,沒有登入或者是沒有許可權時是不能讓使用者直接訪問這些資源的。類似的過濾器還有很多的功能,比如說編碼,壓縮服務端給客戶端返回的各種資料,等等。

2. 過濾器的運作原理?

 過濾器這麼牛逼,那麼它的運作原理是什麼呢?
 java為我們提供了一個Filter介面,我們只需要實現這個介面就能實現自定義過濾器,然後新增一些必要的配置讓過濾器生效。過濾器只能初始化一次,並且過濾器只會在專案停止或者是重新部署的時候才銷燬。我們可以實現的這個Filter介面,裡面最重要的是一個doFilter方法,當我們編寫好Filter,並配置好對那個URL資源進行攔截時,每一次請求這個資源之前就會呼叫這個doFilter方法。並且在這個doFilter方法裡面也有著一個FilterChain的物件引數 ,這個物件裡面也有一個doFilter方法,是否呼叫這個方法決定了這個過濾器是否能呼叫後面的資源或者是執行後面的過濾器。也就是相當於目標資源。所以在過濾器裡面可以進行一些什麼操作呢?可以在呼叫目標資源之前,進行許可權等的處理;判斷是否呼叫目標資源;也可以在呼叫目標資源之後進行一些響應訊息進行處理。

2. 過濾器配置的兩種方法

1. 註解配置 @WebFilter+包掃描@ServletComponentScan("com.example.demofilter.filter")

 首先我們定義一個MyFilter 實現Filter介面。重寫裡面的三個方法

@Order(1)
@WebFilter(filterName = "myFilter1",urlPatterns = {"/*"})
public class MyFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        System.out.println("初始化過濾器");
    }

    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
        System.out.println("進入目標資源之前先乾點啥");
        filterChain.doFilter(servletRequest,servletResponse);
        System.out.println("處理一下服務端返回的response");
    }

    @Override
    public void destroy() {
        System.out.println("過濾器被銷燬了");
    }

程式碼說明:

 1.@WebFilter註解,filterName屬性表示filter的名稱,urlPatter表示要攔截的URL資源,可以是一個或者多個。用於將一個類宣告為過濾器,該註解將會在部署時被容器處理,容器將根據具體的屬性配置將相應的類部署為過濾器。該註解具有下表給出的一些常用屬性 ( 以下所有屬性均為可選屬性,但是 value、urlPatterns、servletNames 三者必需至少包含一個,且 value 和 urlPatterns 不能共存,如果同時指定,通常忽略 value 的取值 )

 2.@Order(1)表示如果有多個攔截器的話就是設定這個攔截器的執行等級,數字越小,越先執行

 3.init()方法只會執行一次,初始化過濾器。

 4.doFilter()核心方法,配置過濾器的邏輯程式碼。

 5.destroy()只會在專案停止或者是專案重新部署的時候才會執行。

 配置完上面的之後我們還需要在啟動類加上一個掃描包的註解,開啟包掃描。@ServletComponentScan("com.example.demofilter.filter"),當然你也可以不用寫包的具體地址,不傳引數,但是建議是傳引數,並且這個採引數也可以傳多個的。

 以上就完成了一個Filter的基本配置,執行專案即可看到效果,還有一種非註解形式的配置方式。

2. java配置 

 我們可以通過自己定義一個java配置檔案,將自定義的Filter 註冊到到FilterRegistrationBean裡面。

@Configuration
public class FilterConfig {
    @Bean
    public FilterRegistrationBean registFilter(){
        FilterRegistrationBean registrationBean = new FilterRegistrationBean();
        registrationBean.setFilter(new MyFilter());
        registrationBean.addUrlPatterns("/*");
        registrationBean.setName("Filter1");
        registrationBean.setOrder(1);
        return registrationBean;
    }
}

 這個配置和上面的註解配置類似。上面註解實現的原理也是這樣的,雖然是兩種不同的方法,但是是一樣的原理。

3. 測試編寫與結果

controller程式碼編寫

@RestController
@RequestMapping("/Filter")
public class FilterController {
    @RequestMapping("/testFilter")
    public String testFilter(){
        System.out.println("filter執行成功");
        return "filter";
    }
}

完成之後啟動專案,訪問介面:localhost:8098/Filter/testFilter,觀察控制檯執行結果。