作者：liuxiaopeng
連結：https://www.cnblogs.com/paddix/p/8365558.html
一、攔截器與過濾器
在講Spring boot之前，我們先了解一下過濾器和攔截器。這兩者在功能方面很類似，但是在具體技術實作方面，差距還是比較大的。在分析兩者的差別之前，我們先了解一下AOP的概念，AOP不是一種具體的技術，而是一種程式設計思想。在面向對象程式設計的過程中，我們很容易通過繼承、多态來解決縱向擴充。 但是對于橫向的功能，比如，在所有的service方法中開啟事務，或者統一記錄日志等功能，面向對象的是無法解決的。是以AOP——面向切面程式設計其實是面向對象程式設計思想的一個補充。而我們今天講的過濾器和攔截器都屬于面向切面程式設計的具體實作。而兩者的主要差別包括以下幾個方面：
1、Filter是依賴于Servlet容器，屬于Servlet規範的一部分，而攔截器則是獨立存在的，可以在任何情況下使用。
2、Filter的執行由Servlet容器回調完成，而攔截器通常通過動态代理的方式來執行。
3、Filter的生命周期由Servlet容器管理，而攔截器則可以通過IoC容器來管理，是以可以通過注入等方式來擷取其他Bean的執行個體，是以使用會更友善。
二、過濾器的配置
現在我們通過過濾器來實作記錄請求執行時間的功能，其實作如下：
@Configurationpublic class FilterConfig { @Bean public FilterRegistrationBean registFilter() { FilterRegistrationBean registration = new FilterRegistrationBean(); registration.setFilter(new LogCostFilter()); registration.addUrlPatterns("/*"); registration.setName("LogCostFilter"); registration.setOrder(1); return registration; } }
這段代碼的邏輯比較簡單，就是在方法執行前先記錄時間戳，然後通過過濾器鍊完成請求的執行，在傳回結果之間計算執行的時間。這裡需要主要，這個類必須繼承Filter類，這個是Servlet的規範，這個跟以前的Web項目沒差別。但是，有了過濾器類以後，以前的web項目可以在web.xml中進行配置，但是spring boot項目并沒有web.xml這個檔案，那怎麼配置？在Spring boot中，我們需要FilterRegistrationBean來完成配置。其實作過程如下：
@Configurationpublic class FilterConfig { @Bean public FilterRegistrationBean registFilter() { FilterRegistrationBean registration = new FilterRegistrationBean(); registration.setFilter(new LogCostFilter()); registration.addUrlPatterns("/*"); registration.setName("LogCostFilter"); registration.setOrder(1); return registration; } }
這樣配置就完成了，需要配置的選項主要包括執行個體化Filter類，然後指定url的比對模式，設定過濾器名稱和執行順序，這個過程和在web.xml中配置其實沒什麼差別，隻是形式不同而已。現在我們可以啟動伺服器通路任意URL：
大家可以看到上面的配置已經生效了。除了通過 FilterRegistrationBean 來配置以外，還有一種更直接的辦法，直接通過注解就可以完成了：
@WebFilter(urlPatterns = "/*", filterName = "logFilter2")public class LogCostFilter2 implements Filter { @Override public void init(FilterConfig filterConfig) throws ServletException { } @Override public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException { long start = System.currentTimeMillis(); filterChain.doFilter(servletRequest, servletResponse); System.out.println("LogFilter2 Execute cost=" + (System.currentTimeMillis() - start)); } @Override public void destroy() { }}
這裡直接用@WebFilter就可以進行配置，同樣，可以設定url比對模式，過濾器名稱等。這裡需要注意一點的是@WebFilter這個注解是Servlet3.0的規範，并不是Spring boot提供的。除了這個注解以外，我們還需在配置類中加另外一個注解：@ServletComponetScan，指定掃描的包。
@[email protected]("com.pandy.blog.dao")@ServletComponentScan("com.pandy.blog.filters")public class Application { public static void main(String[] args) throws Exception { SpringApplication.run(Application.class, args); }}
現在，我們再來通路一下任意URL：
可以看到，我們配置的兩個過濾器都生效了。細心的讀者會發現，第二個Filter我們并沒有指定執行的順序，但是卻在第一個Filter之前執行。這裡需要解釋一下，@WebFilter這個注解并沒有指定執行順序的屬性，其執行順序依賴于Filter的名稱，是根據Filter類名(注意不是配置的filter的名字)的字母順序倒序排列，并且@WebFilter指定的過濾器優先級都高于FilterRegistrationBean配置的過濾器。有興趣的朋友可以自己實驗一下。
三、攔截器的配置
上面我們已經介紹了過濾器的配置方法，接下來我們再來看看如何配置一個攔截器。我們使用攔截器來實作上面同樣的功能，記錄請求的執行時間。首先我們實作攔截器類：
public class LogCostInterceptor implements HandlerInterceptor { long start = System.currentTimeMillis(); @Override public boolean preHandle(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o) throws Exception { start = System.currentTimeMillis(); return true; } @Override public void postHandle(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o, ModelAndView modelAndView) throws Exception { System.out.println("Interceptor cost="+(System.currentTimeMillis()-start)); } @Override public void afterCompletion(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, Object o, Exception e) throws Exception { }}
這裡我們需要實作HandlerInterceptor這個接口，這個接口包括三個方法，preHandle是請求執行前執行的，postHandler是請求結束執行的，但隻有preHandle方法傳回true的時候才會執行，afterCompletion是視圖渲染完成後才執行，同樣需要preHandle傳回true，該方法通常用于清理資源等工作。除了實作上面的接口外，我們還需對其進行配置：
@Configurationpublic class InterceptorConfig extends WebMvcConfigurerAdapter { @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new LogCostInterceptor()).addPathPatterns("/**"); super.addInterceptors(registry); }}
這裡我們繼承了WebMVCConfigurerAdapter，看過前面的文章的朋友應該已經見過這個類了，在進行靜态資源目錄配置的時候我們用到過這個類。這裡我們重寫了addInterceptors這個方法，進行攔截器的配置，主要配置項就兩個，一個是指定攔截器，第二個是指定攔截的URL。現在我們再啟動系統通路任意一個URL：
可以看到，我們通過攔截器實作了同樣的功能。不過這裡還要說明一點的是，其實這個實作是有問題的，因為preHandle和postHandle是兩個方法，是以我們這裡不得不設定一個共享變量start來存儲開始值，但是這樣就會存線上程安全問題。當然，我們可以通過其他方法來解決，比如通過ThreadLocal就可以很好的解決這個問題，有興趣的同學可以自己實作。不過通過這一點我們其實可以看到，雖然攔截器在很多場景下優于過濾器，但是在這種場景下，過濾器比攔截器實作起來更簡單。
四、總結
本文主要對基于Spring boot對過濾器和攔截器的配置進行的講解。無論是過濾器還是攔截器都屬于AOP(面向切面程式設計)思想的具體實作。除了這兩種實作我們還見過另一種更靈活的AOP實作技術，即Aspect，我們可以通過Aspect來完成更多更強大的功能。這個後續有機會再給大家分享。