(转发)SpringBoot实现过滤器、拦截器与切片

Q:使用过滤器、拦截器与切片实现每个请求耗时的统计,并比较三者的区别与联系

过滤器Filter

过滤器概念

Filter是J2E中来的,可以看做是Servlet的一种“加强版”,它主要用于对用户请求进行预处理和后处理,拥有一个典型的处理链。Filter也可以对用户请求生成响应,这一点与Servlet相同,但实际上很少会使用Filter向用户请求生成响应。

使用Filter完整的流程是:Filter对用户请求进行预处理,接着将请求交给Servlet进行预处理并生成响应,最后Filter再对服务器响应进行后处理。

过滤器作用

在JavaDoc中给出了几种过滤器的作用

Examples that have been identified for this design are

1) Authentication Filters, 即用户访问权限过滤

2) Logging and Auditing Filters, 日志过滤,可以记录特殊用户的特殊请求的记录等

3) Image conversion Filters

4) Data compression Filters

5) Encryption Filters

6) Tokenizing Filters

7) Filters that trigger resource access events

8) XSL/T filters

9) Mime-type chain Filter

对于第一条,即使用Filter作权限过滤,其可以这么实现:定义一个Filter,获取每个客户端发起的请求URL,与当前用户无权限访问的URL列表(可以是从DB中取出)作对比,起到权限过滤的作用。

过滤器实现方式

自定义的过滤器都必须实现javax.Servlet.Filter接口,并重写接口中定义的三个方法:

1.void init(FilterConfig config)

用于完成Filter的初始化。

2.void destory()

用于Filter销毁前,完成某些资源的回收。

3.void doFilter(ServletRequest request,ServletResponse response,FilterChain chain)

实现过滤功能,即对每个请求及响应增加的额外的预处理和后处理。,执行该方法之前,即对用户请求进行预处理;执行该方法之后,即对服务器响应进行后处理。

值得注意的是,chain.doFilter()方法执行之前为预处理阶段,该方法执行结束即代表用户的请求已经得到控制器处理。因此,如果在doFilter中忘记调用chain.doFilter()方法,则用户的请求将得不到处理。

importorg.slf4j.Logger;

importorg.slf4j.LoggerFactory;

importorg.springframework.stereotype.Component;

importjavax.servlet.*;

importjavax.servlet.http.HttpServletRequest;

importjava.io.IOException;

// 必须添加注解,springmvc通过web.xml配置

@Component

publicclassTimeFilterimplementsFilter{

privatestaticfinalLogger LOG = LoggerFactory.getLogger(TimeFilter.class);

@Override

publicvoidinit(FilterConfig filterConfig)throwsServletException{

LOG.info("初始化过滤器:{}", filterConfig.getFilterName());

}

@Override

publicvoiddoFilter(ServletRequest request, ServletResponse response, FilterChain chain)throwsIOException, ServletException{

LOG.info("start to doFilter");

longstartTime = System.currentTimeMillis();

chain.doFilter(request, response);

longendTime = System.currentTimeMillis();

LOG.info("the request of {} consumes {}ms.", getUrlFrom(request), (endTime - startTime));

LOG.info("end to doFilter");

}

@Override

publicvoiddestroy(){

LOG.info("销毁过滤器");

}

privateStringgetUrlFrom(ServletRequest servletRequest){

if(servletRequestinstanceofHttpServletRequest){

return((HttpServletRequest) servletRequest).getRequestURL().toString();

}

return"";

}

}

从代码中可看出,类Filter是在javax.servlet.*中,因此可以看出,过滤器的一个很大的局限性在于,其不能够知道当前用户的请求是被哪个控制器(Controller)处理的,因为后者是spring框架中定义的。

在SpringBoot中注册第三方过滤器

对于SpringMvc,可以通过在web.xml中注册过滤器。但在SpringBoot中不存在web.xml,此时如果引用的某个jar包中的过滤器,且这个过滤器在实现时没有使用@Component标识为Spring Bean,则这个过滤器将不会生效。

此时需要通过java代码去注册这个过滤器。以上面定义的TimeFilter为例,当去掉类注解@Component时,注册方式为:

@Configuration

publicclassWebConfig{

/**

* 注册第三方过滤器

* 功能与spring mvc中通过配置web.xml相同

*@return

*/

@Bean

publicFilterRegistrationBeanthirdFilter(){

ThirdPartFilter thirdPartFilter =newThirdPartFilter();

FilterRegistrationBean filterRegistrationBean =newFilterRegistrationBean() ;

filterRegistrationBean.setFilter(thirdPartFilter);

List urls =newArrayList<>();

// 匹配所有请求路径

urls.add("/*");

filterRegistrationBean.setUrlPatterns(urls);

returnfilterRegistrationBean;

}

}

相比使用@Component注解,这种配置方式有个优点,即可以自由配置拦截的URL。

拦截器Interceptor

拦截器概念

拦截器,在AOP(Aspect-Oriented Programming)中用于在某个方法或字段被访问之前,进行拦截,然后在之前或之后加入某些操作。拦截是AOP的一种实现策略。

拦截器作用

日志记录:记录请求信息的日志,以便进行信息监控、信息统计、计算PV(Page View)等

权限检查:如登录检测,进入处理器检测检测是否登录

性能监控:通过拦截器在进入处理器之前记录开始时间,在处理完后记录结束时间,从而得到该请求的处理时间。(反向代理,如apache也可以自动记录);

通用行为:读取cookie得到用户信息并将用户对象放入请求,从而方便后续流程使用,还有如提取Locale、Theme信息等,只要是多个处理器都需要的即可使用拦截器实现。

拦截器实现

通过实现HandlerInterceptor接口,并重写该接口的三个方法来实现拦截器的自定义:

1.preHandler(HttpServletRequest request, HttpServletResponse response, Object handler)

方法将在请求处理之前进行调用。SpringMVC中的Interceptor同Filter一样都是链式调用。每个Interceptor的调用会依据它的声明顺序依次执行,而且最先执行的都是Interceptor中的preHandle方法,所以可以在这个方法中进行一些前置初始化操作或者是对当前请求的一个预处理,也可以在这个方法中进行一些判断来决定请求是否要继续进行下去。

该方法的返回值是布尔值Boolean 类型的,当它返回为false时,表示请求结束,后续的Interceptor和Controller都不会再执行;当返回值为true时就会继续调用下一个Interceptor 的preHandle 方法,如果已经是最后一个Interceptor 的时候就会是调用当前请求的Controller 方法。

2.postHandler(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)

在当前请求进行处理之后,也就是Controller 方法调用之后执行,但是它会在DispatcherServlet 进行视图返回渲染之前被调用,所以我们可以在这个方法中对Controller 处理之后的ModelAndView 对象进行操作。

3.afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handle, Exception ex)

该方法也是需要当前对应的Interceptor的preHandle方法的返回值为true时才会执行。顾名思义,该方法将在整个请求结束之后,也就是在DispatcherServlet 渲染了对应的视图之后执行。这个方法的主要作用是用于进行资源清理工作的。

@Component

publicclassTimeInterceptorimplementsHandlerInterceptor{

privatestaticfinalLogger LOG = LoggerFactory.getLogger(TimeInterceptor.class);

@Override

publicbooleanpreHandle(HttpServletRequest request, HttpServletResponse response, Object handler)throwsException{

LOG.info("在请求处理之前进行调用(Controller方法调用之前)");

request.setAttribute("startTime", System.currentTimeMillis());

HandlerMethod handlerMethod = (HandlerMethod) handler;

LOG.info("controller object is {}", handlerMethod.getBean().getClass().getName());

LOG.info("controller method is {}", handlerMethod.getMethod());

// 需要返回true,否则请求不会被控制器处理

returntrue;

}

@Override

publicvoidpostHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView)throwsException{

LOG.info("请求处理之后进行调用,但是在视图被渲染之前(Controller方法调用之后),如果异常发生,则该方法不会被调用");

}

@Override

publicvoidafterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex)throwsException{

LOG.info("在整个请求结束之后被调用,也就是在DispatcherServlet 渲染了对应的视图之后执行(主要是用于进行资源清理工作)");

longstartTime = (long) request.getAttribute("startTime");

LOG.info("time consume is {}", System.currentTimeMillis() - startTime);

}

与过滤器不同的是,拦截器使用@Component修饰后,在SpringBoot中还需要通过实现WebMvcConfigurer手动注册:

// java配置类

@Configuration

publicclassWebConfigimplementsWebMvcConfigurer{

@Autowired

privateTimeInterceptor timeInterceptor;

@Override

publicvoidaddInterceptors(InterceptorRegistry registry){

registry.addInterceptor(timeInterceptor);

}

}

如果是在SpringMVC中,则需要通过xml文件配置<mvc:interceptors>节点信息。

切片Aspect

切片概述

相比过滤器,拦截器能够知道用户发出的请求最终被哪个控制器处理,但是拦截器还有一个明显的不足,即不能够获取request的参数以及控制器处理之后的response。所以就有了切片的用武之地了。

切片实现

切片的实现需要注意@Aspect,@Component以及@Around这三个注解的使用,详细查看官方文档:

https://docs.spring.io/spring/docs/5.0.12.RELEASE/spring-framework-reference/core.html#aop

@Aspect

@Component

publicclassTimeAspect{

privatestaticfinalLogger LOG = LoggerFactory.getLogger(TimeAspect.class);

@Around("execution(* me.ifight.controller.*.*(..))")

publicObjecthandleControllerMethod(ProceedingJoinPoint proceedingJoinPoint)throwsThrowable{

LOG.info("切片开始。。。");

longstartTime = System.currentTimeMillis();

// 获取请求入参

Object[] args = proceedingJoinPoint.getArgs();

Arrays.stream(args).forEach(arg -> LOG.info("arg is {}", arg));

// 获取相应

Object response = proceedingJoinPoint.proceed();

longendTime = System.currentTimeMillis();

LOG.info("请求:{}, 耗时{}ms", proceedingJoinPoint.getSignature(), (endTime - startTime));

LOG.info("切片结束。。。");

returnnull;

}

}

过滤器、拦截器以及切片的调用顺序

如下图,展示了三者的调用顺序Filter->Intercepto->Aspect->Controller。相反的是,当Controller抛出的异常的处理顺序则是从内到外的。因此我们总是定义一个注解@ControllerAdvice去统一处理控制器抛出的异常。

如果一旦异常被@ControllerAdvice处理了,则调用拦截器的afterCompletion方法的参数Exception ex就为空了。

实际执行的调用栈也说明了这一点:

而对于过滤器和拦截器详细的调用顺序如下图:

过滤器和拦截器的区别

最后有必要再说说过滤器和拦截器二者之间的区别:

除此之外,相比过滤器,拦截器能够“看到”用户的请求具体是被Spring框架的哪个控制器所处理。

参考

https://blog.csdn.net/xiaodanjava/article/details/32125687

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 213,335评论 6 492
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,895评论 3 387
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 158,766评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,918评论 1 285
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 66,042评论 6 385
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 50,169评论 1 291
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,219评论 3 412
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,976评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,393评论 1 304
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,711评论 2 328
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,876评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,562评论 4 336
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,193评论 3 317
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,903评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,142评论 1 267
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,699评论 2 362
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,764评论 2 351

推荐阅读更多精彩内容