SpringBoot第五集：整合監聽器/過濾器和攔截器（2020最新最易懂）

　　在實際開發程序中，經常會碰見一些比如系統啟動初始化資訊、統計在線人數、在線用戶數、過濾敏/高詞匯、訪問權限控制(URL級別)等業務需求，實作以上的功能，都會或多或少的用到過濾器、監聽器、攔截器，

一.SpringBoot整合過濾器Filter　　

　　過濾器Filter，是Servlet的的一個實用技術了，可以通過過濾器，對請求進行攔截處理，

1.撰寫Filter過濾器

1. 撰寫普通Java類實作介面Filter，
2. 使用注解@WebFilter標注過濾器類，并配置過濾url，
   

    1 @WebFilter("/*")// 當前配置攔截所有請求
    2 public class TestFilter implements Filter {
    3 
    4     @Override
    5     public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
    6             throws IOException, ServletException {
    7         System.out.println("過濾器Filter測驗執行…………");
    8         chain.doFilter(request, response);// 放行
    9     }
   10 
   11 }

   說明：@WebFilter時Servlet3.0新增的注解，原先實作過濾器，需要在web.xml中進行配置，而現在通過此注解，啟動啟動時會自動掃描自動注冊，

3. 在啟動類加入@ServletComponentScan注解
   使用@ServletComponentScan注解后，Servlet、Filter、Listener可以直接通過@WebServlet、@WebFilter、@WebListener注解自動注冊，
4. 開啟啟動類，訪問測驗，查看控制臺結果

當注冊多個過濾器時，無法指定執行順序，早期使用web.xml配置過濾器時，是可指定執行順序，但使用注解@WebFilter時，沒有順序這個配置屬性，通常情況下，如果對過濾器有特定順序要求的，我們推薦采用原始方式配置，或者參考測驗結果：執行順序和類名字符排序有關，另外SpringBoot也為解決這個問題，單獨提供了一個類FilterRegistrationBean，此類提供setOrder方法，可以為filter設定排序值，讓Spring在注冊Filter之前排序后再依次注冊，

2.解決多過濾器執行順序問題

1. 撰寫兩個/以上Filter，修改Filter的實作（去除注解@WebFilter即可，其他代碼無需改動）
2. 撰寫一個config配置類，利用FilterRegistrationBean實作注冊過濾器，
   FilterRegistrationBean是SpringBoot提供的用于注冊和解決Filter執行順序問題的類，注意在類上使用注解@Configuration，在方法上使用注解@Bean，
   

    1 @Configuration    // 標注為Spring配置beans組件
    2 public class FilterConfig {
    3     
    4     // 注冊第一個Filter
    5     @Bean // 標注為Spring配置bean組件
    6     public FilterRegistrationBean<Filter> registerFilter1() {
    7         //通過FilterRegistrationBean實體設定優先級可以生效
    8         FilterRegistrationBean<Filter> registrationBean = new  FilterRegistrationBean<>();
    9         // 注冊自定義過濾器
   10         registrationBean.setFilter(new TestFilter1());
   11         // 設定過濾器的名字<filter-name>
   12         registrationBean.setName("filter01");
   13         // 設定過濾器的名字過濾路徑<url-partten>
   14         registrationBean.addUrlPatterns("/*");
   15         // 設定過濾器優先級：最頂級
   16         registrationBean.setOrder(1);
   17         return registrationBean;
   18     }
   19     
   20     @Bean
   21     public FilterRegistrationBean<Filter> registerFilter2() {
   22         FilterRegistrationBean<Filter> registrationBean = new  FilterRegistrationBean<>();
   23         // 注冊第二個自定義過濾器TestFilter2
   24         registrationBean.setFilter(new TestFilter2());
   25         registrationBean.setName("filter02");
   26         registrationBean.addUrlPatterns("/*");
   27         registrationBean.setOrder(5);
   28         return registrationBean;
   29     }
   30    
   31 }

3. 開啟啟動類，訪問測驗，查看控制臺結果
   說明：這種方式可以不使用注解@ServletComponentScan

二.SpringBoot整合監聽器Listnner

　　Listnner是servlet規范中定義的一種特殊類，用于監聽ServletContext、HttpSession和servletRequest等域物件的創建和銷毀事件，監聽域物件的屬性發生修改的事件，用于在事件發生前、發生后做一些必要的處理，一般是獲取在線人數等業務需求，

1. 創建普通類實作監聽器介面（比較多，我就不一一列出了）
   本次案例：創建了ServletRequest監聽器，實作介面ServletRequestListnner
   

    1 @WebListener
    2 @Slf4j　　// 該注解等價于Logger  log = new Logger(，，，，)
    3 public class TestListnner implements ServletRequestListener {
    4     @Override
    5     public void requestInitialized(ServletRequestEvent sre) {
    6         log.info("ServletRequest出生…………");
    7     }
    8 
    9     @Override
   10     public void requestDestroyed(ServletRequestEvent sre) {
   11         log.info("ServletRequest銷毀…………");
   12     }
   13 }

2. 在啟動類加入@ServletComponentScan注解
   使用@ServletComponentScan注解后，Servlet、Filter、Listener可以直接通過@WebServlet、@WebFilter、@WebListener注解自動注冊，
3. 開啟啟動類，訪問測驗，查看控制臺結果

三.SpringBoot整合攔截器HandlerInterceptor

　　以上的過濾器、監聽器都屬于Servlet的API，我們在開發中過濾web請求時，還可以使用Spring提供的攔截器(HandlerInterceptor)進行更加精細的控制，

1. 撰寫普通類實作介面HandlerInterceptor，
   

    1 @Slf4j
    2 public class TestHandlerInterceptor implements HandlerInterceptor {
    3 
    4     @Override
    5     public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
    6             throws Exception {
    7         log.info("preHandle請求訪問前，攔截執行……");
    8         // 回傳 false 則請求中斷
    9         return  true;
   10     }
   11 
   12     @Override
   13     public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
   14             ModelAndView modelAndView) throws Exception {
   15         log.info("postHandle請求訪問后，執行……");
   16     }
   17 
   18     @Override
   19     public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
   20             throws Exception {
   21         log.info("afterCompletion請求呼叫完成后回呼方法，即在視圖渲染完成后回呼……");
   22     }
   23     
   24 }

2. 撰寫普通類繼承WebMvcConfigurerAdapter注解攔截器
　　WebMvcConfigurerAdapter配置類是spring提供的一種配置方式，采用JavaBean的方式替代傳統的基于xml的配置來對spring框架進行自定義的配置,可以自定義一些Handler，Interceptor，ViewResolver，MessageConverter，因此，在spring boot提倡的基于注解的配置，采用“約定大于配置”的風格下，當需要進行自定義的配置時，便可以繼承WebMvcConfigurerAdapter這個抽象類，通過JavaBean來實作需要的配置，
　　WebMvcConfigurerAdapter是一個抽象類，它只提供了一些空的介面讓用戶去重寫，比如如果想添加攔截器的時候，需要去重寫一下addInterceptors()這個方法，去配置自定義的攔截器，我們可以看一下WebMvcConfigurerAdapter提供了哪些介面來供我們使用，


    1 public abstract class WebMvcConfigurerAdapter implements WebMvcConfigurer {
    2     /*配置路徑匹配引數*/
    3     public void configurePathMatch(PathMatchConfigurer configurer) {}
    4     /*配置Web Service或REST API設計中內容協商,即根據客戶端的支持內容格式情況來封裝回應訊息體，如xml,json*/
    5     public void configureContentNegotiation(ContentNegotiationConfigurer configurer) {}
    6     /*配置路徑匹配引數*/
    7     public void configureAsyncSupport(AsyncSupportConfigurer configurer) {}
    8     /* 使得springmvc在介面層支持異步*/
    9     public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {}
   10     /* 注冊引數轉換和格式化器*/
   11     public void addFormatters(FormatterRegistry registry) {}
   12     /* 注冊配置的攔截器*/
   13     public void addInterceptors(InterceptorRegistry registry) {}
   14     /* 自定義靜態資源映射*/
   15     public void addResourceHandlers(ResourceHandlerRegistry registry) {}
   16     /* cors跨域訪問*/
   17     public void addCorsMappings(CorsRegistry registry) {}
   18     /* 配置頁面直接訪問，不走介面*/
   19     public void addViewControllers(ViewControllerRegistry registry) {}
   20     /* 注冊自定義的視圖決議器*/
   21     public void configureViewResolvers(ViewResolverRegistry registry) {}
   22     /* 注冊自定義控制器(controller)方法引數型別*/
   23     public void addArgumentResolvers(List<HandlerMethodArgumentResolver> argumentResolvers) {}
   24     /* 注冊自定義控制器(controller)方法回傳型別*/
   25     public void addReturnValueHandlers(List<HandlerMethodReturnValueHandler> returnValueHandlers) {}
   26     /* 多載會覆寫掉spring mvc默認注冊的多個HttpMessageConverter*/
   27     public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {}
   28     /* 僅添加一個自定義的HttpMessageConverter,不覆寫默認注冊的HttpMessageConverter*/
   29     public void extendMessageConverters(List<HttpMessageConverter<?>> converters) {}
   30     /* 注冊例外處理*/
   31     public void configureHandlerExceptionResolvers(List<HandlerExceptionResolver> exceptionResolvers) {}
   32     /* 多個例外處理，可以重寫次方法指定處理順序等*/
   33     public void extendHandlerExceptionResolvers(List<HandlerExceptionResolver> exceptionResolvers) {}
   34 }

   Spring 5.0/SpringBoot 2.0 后，WebMvcConfigurerAdapter被廢棄，取代的方法有兩種：

   ①implements  WebMvcConfigurer（官方推薦）

   ②extends  WebMvcConfigurationSupport

    1 @Configuration  // 標注為Spring組件
    2 public class HandlerInterceptorConfig implements WebMvcConfigurer {
    3     @Override
    4     public void addInterceptors(InterceptorRegistry registry) {
    5         // 添加一個實作HandlerInterceptor介面的攔截器實體
    6         registry.addInterceptor(new TestHandlerInterceptor())
    7             // 用于設定攔截器的過濾路徑規則
    8             .addPathPatterns("/**")
    9             // 用于設定不需要攔截的過濾規則
   10             .excludePathPatterns("/emp/toLogin","/emp/login", "/js/**", "/css/**", "/images/**");
   11     }
   12 }

   注意在類上添加注解@Configuration標注為Spring組件

3. 開啟啟動類，訪問測驗，查看控制臺結果

一張圖理解過濾器，攔截器執行

 目前互聯網上很多大佬都有SpringBoot系列教程，如有雷同，請多多包涵了，畫圖太費事了，圖片來源于網路，

標籤：其他

上一篇：001#撰寫程式步驟

下一篇：python xlwings API介面之NumberFormat用法