SpringBoot 過濾器、攔截器、監(jiān)聽器對比及使用場景分析
一、關(guān)系圖理解
二、區(qū)別
1.過濾器
- 過濾器是在web應(yīng)用啟動的時候初始化一次, 在web應(yīng)用停止的時候銷毀
- 可以對請求的URL進(jìn)行過濾, 對敏感詞過濾
- 擋在攔截器的外層
- 實(shí)現(xiàn)的是 javax.servlet.Filter 接口 ,是 Servlet 規(guī)范的一部分
- 在請求進(jìn)入容器后,但在進(jìn)入servlet之前進(jìn)行預(yù)處理,請求結(jié)束是在servlet處理完以后
- 依賴Web容器
- 會多次執(zhí)行
過濾器簡介
過濾器的英文名稱為 Filter, 是 Servlet 技術(shù)中最實(shí)用的技術(shù)。如同它的名字一樣,過濾器是處于客戶端和服務(wù)器資源文件之間的一道過濾網(wǎng),幫助我們過濾掉一些不符合要求的請求,通常用作 Session 校驗(yàn),判斷用戶權(quán)限,如果不符合設(shè)定條件,則會被攔截到特殊的地址或者基于特殊的響應(yīng)。
過濾器的使用
首先需要實(shí)現(xiàn) Filter接口然后重寫它的三個方法
•init 方法:在容器中創(chuàng)建當(dāng)前過濾器的時候自動調(diào)用
•destory 方法:在容器中銷毀當(dāng)前過濾器的時候自動調(diào)用
•doFilter 方法:過濾的具體操作
1.1HttpServletRequestWrapper
在請求到達(dá)之前對 request 進(jìn)行修改
package com.dingwen.lir.filter; import lombok.extern.slf4j.Slf4j; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletRequestWrapper; import java.util.Arrays; /** * 在請求到達(dá)之前對 request 進(jìn)行修改 * * @author dingwen * 2021.04.30 14:54 */ @Slf4j public class RequestWrapper extends HttpServletRequestWrapper { public RequestWrapper(HttpServletRequest request) { super(request); log.info("RequestWrapper"); } @Override public String getParameter(String name) { // 可以對請求參數(shù)進(jìn)行過濾 return super.getParameter(name); } @Override public String[] getParameterValues(String name) { // 對請求參數(shù)值進(jìn)行過濾 // String[] values =super.getRequest().getParameterValues(name); // return super.getParameterValues(name); return "t e s t".split(" "); } }
1.2 OncePerRequestFilter
OncePerRequestFilter,顧名思義,它能夠確保在一次請求中只通過一次filter
package com.dingwen.lir.filter; import lombok.extern.slf4j.Slf4j; import org.springframework.web.filter.OncePerRequestFilter; import javax.servlet.FilterChain; import javax.servlet.ServletException; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; import java.io.PrintWriter; import java.util.Arrays; /** * 請求過濾器 * OncePerRequestFilter: * OncePerRequestFilter,顧名思義,它能夠確保在一次請求中只通過一次filter. * 大家常識上都認(rèn)為,一次請求本來就只filter一次,為什么還要由此特別限定呢,往往我們的常識和實(shí)際的實(shí)現(xiàn)并不真的一樣,經(jīng)過一番資料的查閱,此方法是為了兼容不同的web container, * 也就是說并不是所有的container都入我們期望的只過濾一次,servlet版本不同,執(zhí)行過程也不同, * 因此,為了兼容各種不同運(yùn)行環(huán)境和版本,默認(rèn)filter繼承OncePerRequestFilter是一個比較穩(wěn)妥的選擇。 * * @author dingwen * 2021.04.30 15:59 */ @Slf4j public class RequestFilter extends OncePerRequestFilter { @Override public void destroy() { super.destroy(); log.info("RequestFilter destroy"); } /* OncePerRequestFilter.doFilter方法中通過request.getAttribute判斷當(dāng)前過濾器是否已執(zhí)行 若未執(zhí)行過,則調(diào)用doFilterInternal方法,交由其子類實(shí)現(xiàn) */ @Override protected void doFilterInternal(HttpServletRequest httpServletRequest, HttpServletResponse httpServletResponse, FilterChain filterChain) throws ServletException, IOException { try { RequestWrapper requestWrapper = new RequestWrapper(httpServletRequest); filterChain.doFilter(requestWrapper, httpServletResponse); log.info("RequestFilter"); log.info(Arrays.toString(requestWrapper.getParameterValues("name"))); } catch (Exception exception) { httpServletResponse.setCharacterEncoding("utf-8"); httpServletResponse.setContentType("application/json; charset=utf-8"); PrintWriter writer = httpServletResponse.getWriter(); writer.write(exception.toString()); } } }
1.3 配置
package com.dingwen.lir.configuration; import com.dingwen.lir.filter.RequestFilter; import com.dingwen.lir.filter.RequestWrapper; import org.springframework.boot.web.servlet.FilterRegistrationBean; import org.springframework.context.annotation.Bean; import org.springframework.context.annotation.Configuration; import javax.servlet.Filter; /** * 過濾器配置類 * * @author dingwen * 2021.04.30 16:10 */ @Configuration public class FilterConfig { @Bean public RequestFilter requestFilter(){ return new RequestFilter(); } @Bean public FilterRegistrationBean<RequestFilter> registrationBean() { FilterRegistrationBean<RequestFilter> registrationBean = new FilterRegistrationBean<>(); registrationBean.setFilter(requestFilter()); registrationBean.addUrlPatterns("/filter/*"); registrationBean.setName("RequestFilter"); //過濾器的級別,值越小級別越高越先執(zhí)行 registrationBean.setOrder(1); return registrationBean; } }
2.攔截器
- 實(shí)現(xiàn) org.springframework.web.servlet.HandlerInterceptor 接口,動態(tài)代理
- 攔截器應(yīng)用場景, 性能分析, 權(quán)限檢查, 日志記錄
- 是一個Spring組件,并由Spring容器管理,并不
- 依賴Tomcat等容器,是可以單獨(dú)使用的。不僅能應(yīng)用在web程序中,也可以用于Application、Swing等程序中
- 是在請求進(jìn)入servlet后,在進(jìn)入Controller之前進(jìn)行預(yù)處理的,Controller 中渲染了對應(yīng)的視圖之后請求結(jié)束
2.1登錄攔截
package com.dingwen.lir.interceptor; import com.dingwen.lir.entity.User; import org.springframework.stereotype.Component; import org.springframework.util.ObjectUtils; import org.springframework.web.servlet.HandlerInterceptor; import javax.servlet.http.HttpServletRequest; import javax.servlet.http.HttpServletResponse; import java.io.IOException; /** * 登錄攔截 * * @author dingwen * 2021.04.25 13:50 */ @Component public class PageInterceptor implements HandlerInterceptor { @Override public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception { User user = (User)request.getSession().getAttribute("user"); if (!ObjectUtils.isEmpty(user)) { return true; } else { // 不管是轉(zhuǎn)發(fā)還是重定向,必須返回false。否則出現(xiàn)多次提交響應(yīng)的錯誤 redirect(request, response); return false; } } /* * 對于請求是ajax請求重定向問題的處理方法 * @param request * @param response * */ public void redirect(HttpServletRequest request, HttpServletResponse response) throws IOException { if("XMLHttpRequest".equals(request.getHeader("X-Requested-With"))){// ajax //獲取當(dāng)前請求的路徑 response.setHeader("Access-Control-Expose-Headers", "REDIRECT,CONTENT_PATH"); //告訴ajax我是重定向 response.setHeader("REDIRECT", "REDIRECT"); //告訴ajax我重定向的路徑 StringBuffer url = request.getRequestURL(); String contextPath = request.getContextPath(); response.setHeader("CONTENT_PATH", url.replace(url.indexOf(contextPath) + contextPath.length(), url.length(), "/").toString()); }else{// http response.sendRedirect( "/page/login"); } response.getWriter().write(403); response.setStatus(HttpServletResponse.SC_FORBIDDEN); } }
2.2配置
package com.dingwen.lir.configuration; import com.dingwen.lir.interceptor.PageInterceptor; import org.springframework.context.annotation.Configuration; import org.springframework.web.servlet.config.annotation.InterceptorRegistry; import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry; import org.springframework.web.servlet.config.annotation.ViewControllerRegistry; import org.springframework.web.servlet.config.annotation.WebMvcConfigurer; /** * mvc 控制器配置 * MyWebMvcConfigurer: Springboot2.x以后版本使用 * * @author dingwen * 2021.04.26 17:52 */ @Configuration public class MyWebMvcConfigurer implements WebMvcConfigurer { /* * 攔截器依賴于Spring容器,此處攔截了所有,需要對靜態(tài)資源進(jìn)行放行 */ @Override public void addInterceptors(InterceptorRegistry registry) { // 攔截器默認(rèn)的執(zhí)行順序,就是它的注冊順序,也可以通過Order手動設(shè)置控制,值越小越先執(zhí)行。 // registry.addInterceptor(new PageInterceptor()).addPathPatterns("/**").order() registry.addInterceptor(new PageInterceptor()).addPathPatterns("/**") .excludePathPatterns("/page/login", "/user/login","/page/ajax","/static/**"); } /* * 不要要寫控制器即可完成頁面跳轉(zhuǎn)訪問 * @param registry */ @Override public void addViewControllers(ViewControllerRegistry registry) { registry.addViewController("/page/ajax").setViewName("ajax"); } /* * 自定義靜態(tài)資源映射 Spring Boot 默認(rèn)為我們提供了靜態(tài)資源映射: classpath:/META-INF/resources classpath:/resources classpath:/static classpath:/public 優(yōu)先級:META-INF/resources > resources > static > public * @param registry * */ // @Override // public void addResourceHandlers(ResourceHandlerRegistry registry) { registry.addResourceHandler("/static/**").addResourceLocations("classpath:/static/"); registry.addResourceHandler("/static/**").addResourceLocations("file:E:/static/"); // } }
3.監(jiān)聽器
- 實(shí)現(xiàn) javax.servlet.ServletRequestListener, javax.servlet.http.HttpSessionListener, javax.servlet.ServletContextListener 等等接口
- 主要用來監(jiān)聽對象的創(chuàng)建與銷毀的發(fā)生, 比如 session 的創(chuàng)建銷毀, request 的創(chuàng)建銷毀, ServletContext 創(chuàng)建銷毀
三、注意
1.靜態(tài)資源問題
SpringBoot2.x以后版本攔截器也會攔截靜態(tài)資源,在配置攔截器是需要將姿態(tài)資源放行。
/* * 攔截器依賴于Spring容器,此處攔截了所有,需要對靜態(tài)資源進(jìn)行放行 */ @Override public void addInterceptors(InterceptorRegistry registry) { registry.addInterceptor(new PageInterceptor()).addPathPatterns("/**") .excludePathPatterns("/page/login", "/user/login","/page/ajax","/static/**"); }
SpringBoot2.x 自定義靜態(tài)資源映射
spring: mvc: static-path-pattern: /static/**
默認(rèn)目錄
classpath:/META-INF/resources
classpath:/resources
classpath:/static
classpath:/public
優(yōu)先級:META-INF/resources > resources > static > public
2.登錄攔截ajax重定向
由于ajax是異步的,還在當(dāng)前頁面進(jìn)行的局部請求。當(dāng)攔截到登錄請求時,即使重定向也無法生效。需采用服務(wù)端給地址由前端進(jìn)行跳轉(zhuǎn)。詳細(xì)見登錄攔截器代碼。
// 前端處理 <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>AJAX</title> <script src="https://code.jquery.com/jquery-3.0.0.min.js"></script> </head> <body> <button>USER</button> </body> </html> <script> $.ajaxSetup({ complete:function(xhr,status){ //攔截器實(shí)現(xiàn)超時跳轉(zhuǎn)到登錄頁面 let win = window; // 通過xhr取得響應(yīng)頭 let REDIRECT = xhr.getResponseHeader("REDIRECT"); //如果響應(yīng)頭中包含 REDIRECT 則說明是攔截器返回的需要重定向的請求 if (REDIRECT === "REDIRECT") { while (win !== win.top) { win = win.top; } win.location.href = xhr.getResponseHeader("CONTEXTPATH"); } } }); $("button").click(function(){ $.get("/page/user", function(result){ $("div").html(result); }); }); </script>
四、測試
代碼地址:https://gitee.com/dingwen-gitee/filter-interceptor-study.git
1.攔截器測試
1.1啟動項(xiàng)目訪問首頁
http://localhost:8080/page/index
由于沒有登錄,直接重定向到了登錄頁
1.2輸入用戶名密碼完成登錄,調(diào)轉(zhuǎn)到用戶頁
此時在訪問首頁
1.2 退出登錄
成功退出后,訪問為授權(quán)的頁面也相對會被重定向到登錄頁
1.3 ajax未授權(quán)訪問測試
點(diǎn)擊訪問user ,由于未登錄,沒有全權(quán)訪問。在前端進(jìn)行了頁面跳轉(zhuǎn),轉(zhuǎn)到了登錄頁。
2.過濾器測試
可以看到過濾器進(jìn)行了相對應(yīng)的處理,重寫的getParameterValues()也生效了。配合使用HttpServletRequestWrapper & OncePerRequestFilter 實(shí)現(xiàn)了對request的修改。
到此這篇關(guān)于SpringBoot 過濾器、攔截器、監(jiān)聽器對比及使用場景分析的文章就介紹到這了,更多相關(guān)SpringBoot 過濾器、攔截器、監(jiān)聽器內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家!
相關(guān)文章
Java IO復(fù)用_動力節(jié)點(diǎn)Java學(xué)院整理
這篇文章主要介紹了Java IO復(fù)用的相關(guān)知識,非常不錯,具有參考借鑒價值,需要的的朋友參考下吧2017-05-05PHP Laravel實(shí)現(xiàn)文件下載功能
本文重點(diǎn)給大家介紹Laravel實(shí)現(xiàn)文件下載功能的實(shí)例代碼,需要的朋友參考下吧2017-09-09SpringCloudAlibaba微服務(wù)調(diào)用組件OpenFeign的方法
Feign是Netflix開發(fā)的聲明式、模板化的HTTP客戶端,其靈感來自Retrofit、JAXRS-2.0以及WebSocket,Feign可幫助我們更加便捷、優(yōu)雅地調(diào)用HTTP API,這篇文章主要介紹了SpringCloudAlibaba微服務(wù)調(diào)用組件OpenFeign,需要的朋友可以參考下2024-07-07關(guān)于Java8 parallelStream并發(fā)安全的深入講解
這篇文章主要給大家介紹了關(guān)于Java8 parallelStream并發(fā)安全的相關(guān)資料,文中通過示例代碼介紹的非常詳細(xì),對大家的學(xué)習(xí)或者工作具有一定的參考學(xué)習(xí)價值,需要的朋友們下面隨著小編來一起學(xué)習(xí)學(xué)習(xí)吧2018-10-10關(guān)于MyBatis Plus中使用or和and問題
這篇文章主要介紹了關(guān)于MyBatis Plus中使用or和and問題,需要的朋友可以參考下2020-12-12SpringBoot實(shí)現(xiàn)過濾器、攔截器與切片的實(shí)現(xiàn)和區(qū)別
本文詳細(xì)介紹了使用過濾器、攔截器與切片實(shí)現(xiàn)每個請求耗時的統(tǒng)計,并比較三者的區(qū)別與聯(lián)系,小編覺得挺不錯的,現(xiàn)在分享給大家,也給大家做個參考。一起跟隨小編過來看看吧2019-02-02