轉自:
https://blog.csdn.net/cp026la/article/details/86501019
簡介:
本章介紹攔截器、過濾器、切片對請求攔截的使用與區別,以及監聽器在 springboot1.5 中的簡單使用
過濾器、攔截器、切片攔截請求的對比:
相同點: 都可以對請求進行攔截。
不同點:
1、過濾器對請求的攔截只能獲取到原始的Request 和 Response 的信息。
2、攔截器對請求的攔截可以獲取原始的Request、Response和所有的controller及方法名,但無法獲取方法的參數信息。
3、Aspect切片只能獲取方法的參數,原始的Request、Response不能獲取。
所以,實際項目需根據需求選擇使用何種方式攔截請求。
一、過濾器:
1、實現Filter接口
/**
* @Auther: xf
* @Date: 2018/11/19 19:30
* @Description: 自定義過濾器
*
* Filter 只能獲取request 和 response 並不知道請求是哪個 controller 處理的
*/
@Slf4j
public class CustomFilter implements Filter {
@Override
public void init(FilterConfig filterConfig) throws ServletException {
log.info("過濾器初始化>>>>>>>");
}
/**
* 請求被攔截的時候進行調用
*/
@Override
public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
log.info(">>>>>>>>>>>>過濾器攔截請求處理邏輯>>>>>>>>>>>>>");
// 業務邏輯
long startTime = System.currentTimeMillis();
// 過濾器鏈,給下一個過濾器
filterChain.doFilter(servletRequest, servletResponse);
log.info("請求時間:" + (System.currentTimeMillis() - startTime));
}
@Override
public void destroy() {
log.info("過濾器銷毀>>>>>>>");
}
}
2、過濾器配置類:
傳統的web項目中,過濾器的配置是在web.xml中添加。SpringBoot需要使用FilterRegistrationBean來完成配置。
/**
* @Auther: xf
* @Date: 2018/11/19 19:58
* @Description: 傳統的項目配置 Filter 在 web.xml 中添加
* 在Spring boot中,我們需要 FilterRegistrationBean 來完成配置
*/
@Configuration
public class CustomFilterConfig {
@Bean
public FilterRegistrationBean customFilter() {
FilterRegistrationBean registration = new FilterRegistrationBean();
registration.setFilter(new CustomFilter());
registration.addUrlPatterns("/*");
registration.setName("customFilter");
registration.setOrder(1);
return registration;
}
}
3、啟動項目,隨便請求一個接口測試效果:
控制台有攔截器的日志。
4、配置過濾器的方式二:
直接通過@WebFilter注解配置(注釋掉上面的CustomFilterConfig配置類)
@Slf4j
// 多個過濾器,使用此注解指定執行順序,越小越先執行
@Order(1)
// 在 CustomFilterConfig 中配置 注釋掉 @WebFilter
@WebFilter(urlPatterns = "/*", filterName = "customFilter")
public class CustomFilter implements Filter {
...
}
注意:
@WebFilter 是Servlet3.0 的規范,並不是SpringBoot提供的,需加上@ServletComponentScan注解掃描指定的包。我們這里加到啟動類上。
// filter和servlet、listener之類的需要單獨進行注冊才能使用,spring boot里面提供了該注解起到注冊作用
@ServletComponentScan
// mapper 接口類掃描包配置
@MapperScan("com.coolron.*.dao")
@SpringBootApplication(scanBasePackages = "com.coolron")
public class SpringbootApplication {
...
}
二、攔截器:
1、自定義攔截器1:
@Slf4j
public class MyInterceptor1 implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
log.info(">>>MyInterceptor1>>>>>>>在請求處理之前進行調用(Controller方法調用之前)");
return true;// 只有返回true才會繼續向下執行,返回false取消當前請求
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
ModelAndView modelAndView) throws Exception {
log.info(">>>MyInterceptor1>>>>>>>請求處理之后進行調用,但是在視圖被渲染之前(Controller方法調用之后)");
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
throws Exception {
log.info(">>>MyInterceptor1>>>>>>>在整個請求結束之后被調用,也就是在DispatcherServlet 渲染了對應的視圖之后執行(主要是用於進行資源清理工作)");
}
}
2、自定義攔截器2:
/**
* 自定義攔截器2
*/
@Slf4j
public class MyInterceptor2 implements HandlerInterceptor {
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler)
throws Exception {
log.info(">>>MyInterceptor2>>>>>>>在請求處理之前進行調用(Controller方法調用之前)");
return true;// 只有返回true才會繼續向下執行,返回false取消當前請求
}
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler,
ModelAndView modelAndView) throws Exception {
log.info(">>>MyInterceptor2>>>>>>>請求處理之后進行調用,但是在視圖被渲染之前(Controller方法調用之后)");
}
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)
throws Exception {
log.info(">>>MyInterceptor2>>>>>>>在整個請求結束之后被調用,也就是在DispatcherServlet 渲染了對應的視圖之后執行(主要是用於進行資源清理工作)");
}
}
3、攔截器配置類:
/**
* @Auther: xf
* @Date: 2018/11/19 21:09
* @Description:
*/
@Configuration
public class InterceptorConfig extends WebMvcConfigurerAdapter {
/*
* 攔截器配置
* 在spring-mvc.xml配置文件內添加<mvc:interceptor>標簽配置攔截器。
*/
@Override
public void addInterceptors(InterceptorRegistry registry) {
// 多個攔截器組成一個攔截器鏈
// addPathPatterns 用於添加攔截規則
// excludePathPatterns 用戶排除攔截
registry.addInterceptor(new MyInterceptor1()).addPathPatterns("/**").excludePathPatterns("/login");
registry.addInterceptor(new MyInterceptor2()).addPathPatterns("/**");
// 父類的配置
super.addInterceptors(registry);
}
}
三、Aspect切片攔截:
1、自定義切片:
/**
* @Description:
* 可以拿到請求的具體controller 對應的方法的具體參數值 但是拿不到 原始的request 和 response
*
* 切入點(注解):
* 1、 在哪些方法上起作用
* 2、 什么時候起作用
*
* 增強(方法)
* 1、起作用是執行的業務邏輯
*/
// 聲明切片類
@Slf4j
@Aspect
@Component
public class CustomAspect {
// 在什么時候起作用
// @Before() 相當於攔截器的 PreHandle() 方法
// @After() 攔截的方法響應之后執行
// @AfterThrowing 方法拋出某些異常的時候調用
// @Around 環繞 覆蓋前面三種
// 環繞的方式調用下面的方法
@Around("execution(* com.coolron.*.controller..*.*(..))")
// ProceedingJoinPoint 類 包含了當前攔截的方法的一些信息
public Object method(ProceedingJoinPoint pjp) throws Throwable {
log.info("=====Aspect處理=======");
Object[] args = pjp.getArgs();
for (Object arg : args) {
log.info("參數為:" + arg);
}
long start = System.currentTimeMillis();
// 相當於Filter 的 chain.doFilter() 調用被攔截的那個方法 返回值 object 與 controller中方法的返回值相同
Object object = pjp.proceed();
log.info("Aspect 耗時:" + (System.currentTimeMillis() - start));
return object;
}
}
execution表達式參看SpringBoot>07 - 事物處理。
2、啟動訪問任意接口:
觀察控制台發現Filter、Interceptor、切片執行順序:
攔截順序 : Filter >>> Interceptor >>> Aspect >>> controller
若果有異常返回結果: controller >>> Aspect >>> ControllerAdvice(全局異常處理類上) >>> Interceptor >>> Filter
四、監聽器:
1、自定義監聽器,實現ServletRequestListener接口
/**
* @Auther: xf
* @Date: 2018/11/19 21:42
* @Description: 監聽器
*/
@Slf4j
@WebListener
public class RequestListener implements ServletRequestListener {
@Override
public void requestDestroyed(ServletRequestEvent servletRequestEvent) {
log.info("監聽器銷毀>>>>>");
}
@Override
public void requestInitialized(ServletRequestEvent servletRequestEvent) {
log.info("監聽器初始化>>>>>");
}
}
2、測試:隨便請求一個接口會看到監聽器初始化和銷毀的日志。
注意:案例中實現的是request的監聽器。用於監聽request對象的創建、銷毀。
常見的監聽器:
1、HttpSessionListener:監聽session對象的創建、銷毀
2、ServletRequestListener:監聽request對象的創建、銷毀
3、ServletContextListener:監聽servletContext對象的創建、銷毀
