SpringBoot 過(guò)濾器、攔截器、監(jiān)聽(tīng)器對(duì)比及使用場(chǎng)景分析
過(guò)濾器簡(jiǎn)介
過(guò)濾器的英文名稱(chēng)為 Filter, 是 Servlet 技術(shù)中最實(shí)用的技術(shù)。如同它的名字一樣,過(guò)濾器是處于客戶端和服務(wù)器資源文件之間的一道過(guò)濾網(wǎng),幫助我們過(guò)濾掉一些不符合要求的請(qǐng)求,通常用作 Session 校驗(yàn),判斷用戶權(quán)限,如果不符合設(shè)定條件,則會(huì)被攔截到特殊的地址或者基于特殊的響應(yīng)。
過(guò)濾器的使用
首先需要實(shí)現(xiàn) Filter接口然后重寫(xiě)它的三個(gè)方法•init 方法:在容器中創(chuàng)建當(dāng)前過(guò)濾器的時(shí)候自動(dòng)調(diào)用•destory 方法:在容器中銷(xiāo)毀當(dāng)前過(guò)濾器的時(shí)候自動(dòng)調(diào)用•doFilter 方法:過(guò)濾的具體操作
1.1HttpServletRequestWrapper
在請(qǐng)求到達(dá)之前對(duì) 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;/** * 在請(qǐng)求到達(dá)之前對(duì) request 進(jìn)行修改 * * @author dingwen * 2021.04.30 14:54 */@Slf4jpublic class RequestWrapper extends HttpServletRequestWrapper { public RequestWrapper(HttpServletRequest request) {super(request);log.info('RequestWrapper'); } @Override public String getParameter(String name) {// 可以對(duì)請(qǐng)求參數(shù)進(jìn)行過(guò)濾return super.getParameter(name); } @Override public String[] getParameterValues(String name) {// 對(duì)請(qǐng)求參數(shù)值進(jìn)行過(guò)濾//String[] values =super.getRequest().getParameterValues(name);//return super.getParameterValues(name);return 't e s t'.split(' '); }}
1.2 OncePerRequestFilter
OncePerRequestFilter,顧名思義,它能夠確保在一次請(qǐng)求中只通過(guò)一次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;/** * 請(qǐng)求過(guò)濾器 * OncePerRequestFilter: * OncePerRequestFilter,顧名思義,它能夠確保在一次請(qǐng)求中只通過(guò)一次filter. * 大家常識(shí)上都認(rèn)為,一次請(qǐng)求本來(lái)就只filter一次,為什么還要由此特別限定呢,往往我們的常識(shí)和實(shí)際的實(shí)現(xiàn)并不真的一樣,經(jīng)過(guò)一番資料的查閱,此方法是為了兼容不同的web container, * 也就是說(shuō)并不是所有的container都入我們期望的只過(guò)濾一次,servlet版本不同,執(zhí)行過(guò)程也不同, * 因此,為了兼容各種不同運(yùn)行環(huán)境和版本,默認(rèn)filter繼承OncePerRequestFilter是一個(gè)比較穩(wěn)妥的選擇。 * * @author dingwen * 2021.04.30 15:59 */@Slf4jpublic class RequestFilter extends OncePerRequestFilter { @Override public void destroy() {super.destroy();log.info('RequestFilter destroy'); } /* OncePerRequestFilter.doFilter方法中通過(guò)request.getAttribute判斷當(dāng)前過(guò)濾器是否已執(zhí)行 若未執(zhí)行過(guò),則調(diào)用doFilterInternal方法,交由其子類(lèi)實(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;/** * 過(guò)濾器配置類(lèi) * * @author dingwen * 2021.04.30 16:10 */@Configurationpublic 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');//過(guò)濾器的級(jí)別,值越小級(jí)別越高越先執(zhí)行registrationBean.setOrder(1);return registrationBean; }}2.攔截器 實(shí)現(xiàn) org.springframework.web.servlet.HandlerInterceptor 接口,動(dòng)態(tài)代理 攔截器應(yīng)用場(chǎng)景, 性能分析, 權(quán)限檢查, 日志記錄 是一個(gè)Spring組件,并由Spring容器管理,并不 依賴Tomcat等容器,是可以單獨(dú)使用的。不僅能應(yīng)用在web程序中,也可以用于Application、Swing等程序中 是在請(qǐng)求進(jìn)入servlet后,在進(jìn)入Controller之前進(jìn)行預(yù)處理的,Controller 中渲染了對(duì)應(yīng)的視圖之后請(qǐ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 */@Componentpublic 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)的錯(cuò)誤 redirect(request, response); return false;} } /* * 對(duì)于請(qǐng)求是ajax請(qǐng)求重定向問(wèn)題的處理方法 * @param request * @param response * */ public void redirect(HttpServletRequest request, HttpServletResponse response) throws IOException {if('XMLHttpRequest'.equals(request.getHeader('X-Requested-With'))){// ajax //獲取當(dāng)前請(qǐ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 */@Configurationpublic class MyWebMvcConfigurer implements WebMvcConfigurer { /* * 攔截器依賴于Spring容器,此處攔截了所有,需要對(duì)靜態(tài)資源進(jìn)行放行 */ @Override public void addInterceptors(InterceptorRegistry registry) {// 攔截器默認(rèn)的執(zhí)行順序,就是它的注冊(cè)順序,也可以通過(guò)Order手動(dòng)設(shè)置控制,值越小越先執(zhí)行。//registry.addInterceptor(new PageInterceptor()).addPathPatterns('/**').order()registry.addInterceptor(new PageInterceptor()).addPathPatterns('/**').excludePathPatterns('/page/login', '/user/login','/page/ajax','/static/**'); } /* * 不要要寫(xiě)控制器即可完成頁(yè)面跳轉(zhuǎn)訪問(wè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/resourcesclasspath:/resourcesclasspath:/staticclasspath:/public 優(yōu)先級(jí):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)聽(tīng)器 實(shí)現(xiàn) javax.servlet.ServletRequestListener, javax.servlet.http.HttpSessionListener, javax.servlet.ServletContextListener 等等接口 主要用來(lái)監(jiān)聽(tīng)對(duì)象的創(chuàng)建與銷(xiāo)毀的發(fā)生, 比如 session 的創(chuàng)建銷(xiāo)毀, request 的創(chuàng)建銷(xiāo)毀, ServletContext 創(chuàng)建銷(xiāo)毀三、注意1.靜態(tài)資源問(wèn)題
SpringBoot2.x以后版本攔截器也會(huì)攔截靜態(tài)資源,在配置攔截器是需要將姿態(tài)資源放行。
/* * 攔截器依賴于Spring容器,此處攔截了所有,需要對(duì)靜態(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/resourcesclasspath:/resourcesclasspath:/staticclasspath:/public優(yōu)先級(jí):META-INF/resources > resources > static > public
2.登錄攔截ajax重定向由于ajax是異步的,還在當(dāng)前頁(yè)面進(jìn)行的局部請(qǐng)求。當(dāng)攔截到登錄請(qǐng)求時(shí),即使重定向也無(wú)法生效。需采用服務(wù)端給地址由前端進(jìn)行跳轉(zhuǎn)。詳細(xì)見(jiàn)登錄攔截器代碼。
// 前端處理<!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)超時(shí)跳轉(zhuǎn)到登錄頁(yè)面 let win = window; // 通過(guò)xhr取得響應(yīng)頭 let REDIRECT = xhr.getResponseHeader('REDIRECT'); //如果響應(yīng)頭中包含 REDIRECT 則說(shuō)明是攔截器返回的需要重定向的請(qǐng)求 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>四、測(cè)試
代碼地址:https://gitee.com/dingwen-gitee/filter-interceptor-study.git
1.攔截器測(cè)試1.1啟動(dòng)項(xiàng)目訪問(wèn)首頁(yè)
http://localhost:8080/page/index
由于沒(méi)有登錄,直接重定向到了登錄頁(yè)
1.2輸入用戶名密碼完成登錄,調(diào)轉(zhuǎn)到用戶頁(yè)
此時(shí)在訪問(wèn)首頁(yè)
1.2 退出登錄
成功退出后,訪問(wèn)為授權(quán)的頁(yè)面也相對(duì)會(huì)被重定向到登錄頁(yè)
1.3 ajax未授權(quán)訪問(wèn)測(cè)試
點(diǎn)擊訪問(wèn)user ,由于未登錄,沒(méi)有全權(quán)訪問(wèn)。在前端進(jìn)行了頁(yè)面跳轉(zhuǎn),轉(zhuǎn)到了登錄頁(yè)。
可以看到過(guò)濾器進(jìn)行了相對(duì)應(yīng)的處理,重寫(xiě)的getParameterValues()也生效了。配合使用HttpServletRequestWrapper & OncePerRequestFilter 實(shí)現(xiàn)了對(duì)request的修改。
到此這篇關(guān)于SpringBoot 過(guò)濾器、攔截器、監(jiān)聽(tīng)器對(duì)比及使用場(chǎng)景分析的文章就介紹到這了,更多相關(guān)SpringBoot 過(guò)濾器、攔截器、監(jiān)聽(tīng)器內(nèi)容請(qǐng)搜索好吧啦網(wǎng)以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持好吧啦網(wǎng)!
相關(guān)文章:
1. 基于Surprise協(xié)同過(guò)濾實(shí)現(xiàn)短視頻推薦方法示例2. vue-electron中修改表格內(nèi)容并修改樣式3. PHP獲取時(shí)間戳等相關(guān)函數(shù)匯總4. AJAX實(shí)現(xiàn)文件上傳功能報(bào)錯(cuò)Current request is not a multipart request詳解5. 不使用XMLHttpRequest對(duì)象實(shí)現(xiàn)Ajax效果的方法小結(jié)6. 推薦一個(gè)好看Table表格的css樣式代碼詳解7. ASP新手必備的基礎(chǔ)知識(shí)8. ASP常用日期格式化函數(shù) FormatDate()9. 以PHP代碼為實(shí)例詳解RabbitMQ消息隊(duì)列中間件的6種模式10. 微信小程序?qū)崿F(xiàn)商品分類(lèi)頁(yè)過(guò)程結(jié)束
