SpringBoot入坑指南之六：使用过滤器或拦截器

时间 2019-11-06

原文原文链接

开篇

在Web应用中，经常存在拦截所有或部分请求进行统一处理的应用场景，如权限校验、参数校验、性能监控等。在SpringMVC框架中，咱们能够经过过滤器或拦截器实现相关功能，spring-boot-starter-web模块底层实际就是SpringMVC框架，那么在SpringBoot项目中如何使用过滤器或拦截器呢？git

过滤器与拦截器的区别

项目	过滤器Filter	拦截器Interceptor	说明
规范定义	Servlet规范中定义，与SpringMVC框架无关。	SpringMVC提供组件之一。	过滤器不依赖于Spring MVC框架。
调用顺序	在Spring DispatchServlet执行前	在Spring DispatchServlet中调用	故过滤器执行会在拦截器以前。
容器资源	没法使用Spring容器资源，若是须要使用，能够经过ApplicationContext上下文对象获取	拦截器自己就是Spring的容器资源，能够经过Ioc进行依赖注	入直接使用容器资源。

过滤器与拦截器的使用

建立项目

建立一个maven项目spring-boot-examples-intercept，添加一下依赖：web

<dependencies>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.projectlombok</groupId>
            <artifactId>lombok</artifactId>
        </dependency>
    </dependencies>

添加业务接口

添加一个HelloController类，实现一个Restful的测试接口/hello，代码以下：spring

@RestController
@Slf4j
public class HelloController {

    /**
     * 测试请求方法
     *
     * @return
     */
    @GetMapping("/hello")
    public String hello() {
        log.info("[{}]执行{}方法！", this.getClass().getSimpleName(), "hello");
        return "Hello!";
    }
}

添加过滤器

过滤器开发

添加第一个过滤器FirstFilter类，实现Filter接口，代码以下：

@Slf4j
public class FirstFilter implements Filter {

    /**
     *
     * @param servletRequest
     * @param servletResponse
     * @param filterChain
     * @throws IOException
     * @throws ServletException
     */
    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
        log.info("[{}]执行{}方法：Before！", this.getClass().getSimpleName(), "doFilter");
        //执行下一个filter
        filterChain.doFilter(servletRequest, servletResponse);
        log.info("[{}]执行{}方法：After！", this.getClass().getSimpleName(), "doFilter");
    }
}

添加第二个过滤器SecondFilter类，实现Filter接口，代码以下：

@Slf4j
public class SecondFilter implements Filter {

    /**
     * @param servletRequest
     * @param servletResponse
     * @param filterChain
     * @throws IOException
     * @throws ServletException
     */
    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
        log.info("[{}]执行{}方法：Before！", this.getClass().getSimpleName(), "doFilter");
        //执行下一个filter
        filterChain.doFilter(servletRequest, servletResponse);
        log.info("[{}]执行{}方法：After！", this.getClass().getSimpleName(), "doFilter");
    }
}

过滤器配置

配置过滤器有两种方式，分别是经过配置类或者注解的方式，两种方式均可以将过滤器配置到服务中，可是经过注解的方式我还没发现指定过滤器顺序的方法（经过@Order注解是无效的），因此若是须要指定过滤器执行顺序的，建议使用方式一，不然使用方式二代码更简洁。后端

方式一：经过配置类配置过滤器。 添加一个Spring Boot的配置类FilterConfig，里面注册两个FilterRegistrationBean类型的Bean，代码以下：

@Configuration
public class FilterConfig {

    /**
     * 注册第一个过滤器
     * @return
     */
    @Bean
    public FilterRegistrationBean firstFilter() {
        FilterRegistrationBean registrationBean = new FilterRegistrationBean(new FirstFilter());
        //可不设置，默认过滤路径即为：/*
        registrationBean.addUrlPatterns("/*");
        registrationBean.setOrder(1);
        return registrationBean;
    }

    /**
     * 注册第二个过滤器
     * @return
     */
    @Bean
    public FilterRegistrationBean secondFilter() {
        FilterRegistrationBean registrationBean = new FilterRegistrationBean(new SecondFilter());
        //可不设置，默认过滤路径即为：/*
        registrationBean.addUrlPatterns("/*");
        registrationBean.setOrder(2);
        return registrationBean;
    }
}

方式二：经过注解配置过滤器 在FirstFilter和SecondFilter类上分别添加注解配置@WebFilter(urlPatterns = "/*")，因为@WebFilter并非Spring提供的注解，因此还须要在项目的启动类中添加注解配置@ServletComponentScan，告诉Spring扫描路径，以下：

@SpringBootApplication
@ServletComponentScan(basePackages = "org.cent.springboot.example.intercept.filter")
public class Application {

    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

添加拦截器

开发拦截器

添加第一个拦截器FirstInterceptor类，实现HandlerInterceptor接口，代码以下：

@Slf4j
public class FirstInterceptor implements HandlerInterceptor {

    /**
     * controller方法调用前调用。
     *
     * @param request
     * @param response
     * @param handler
     * @return 往下执行则返回true，不然返回false
     * @throws Exception
     */
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        log.info("[{}]执行{}方法！", this.getClass().getSimpleName());
        return true;
    }

    /**
     * controller方法调用后视图渲染前执行。
     *
     * @param request
     * @param response
     * @param handler
     * @param modelAndView
     * @throws Exception
     */
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        log.info("[{}]执行{}方法！", this.getClass().getSimpleName(), "postHandle");
    }

    /**
     * controller方法调用且视图渲染完成后执行
     *
     * @param request
     * @param response
     * @param handler
     * @param ex
     * @throws Exception
     */
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        log.info("[{}]执行{}方法！", this.getClass().getSimpleName(), "afterCompletion");
    }

添加第二个拦截器SecondInterceptor类，实现HandlerInterceptor接口，代码以下：

@Slf4j
public class SecondInterceptor implements HandlerInterceptor {

    /**
     * controller方法调用前调用。
     *
     * @param request
     * @param response
     * @param handler
     * @return 往下执行则返回true，不然返回false
     * @throws Exception
     */
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        log.info("[{}]执行{}方法！", this.getClass().getSimpleName(), "preHandle");
        return true;
    }

    /**
     * controller方法调用后视图渲染前执行。
     *
     * @param request
     * @param response
     * @param handler
     * @param modelAndView
     * @throws Exception
     */
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        log.info("[{}]执行{}方法！", this.getClass().getSimpleName(), "postHandle");
    }

    /**
     * controller方法调用且视图渲染完成后执行
     *
     * @param request
     * @param response
     * @param handler
     * @param ex
     * @throws Exception
     */
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        log.info("[{}]执行{}方法！", this.getClass().getSimpleName(), "afterCompletion");
    }

配置拦截器

添加一个Spring Boot配置类，实现WebMvcConfigurer接口以覆盖容器默认配置，代码以下：springboot

@Configuration
public class InterceptorConfig implements WebMvcConfigurer {

    /**
     * 重写添加拦截器方法
     *
     * @param registry
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new FirstInterceptor())
                .addPathPatterns("/**")
                .order(1);//指定执行顺序，数值越小越优先
        registry.addInterceptor(new SecondInterceptor())
                .addPathPatterns("/hello")
                .order(2);//指定执行顺序，数值越小越优先
    }

}

启动测试

启动服务，访问http://localhost:8120/hello接口，后台输入日志以下图，会发现Filter执行会在Interceptor以前，也验证上面表格中的说法。 app

示例代码

码云：https://gitee.com/centy/spring-boot-examples/tree/master/spring-boot-examples-intercept框架

尾巴

过滤器依赖于Servlet容器，而Interceptor则为SpringMVC的一部分。过滤器可以拦截全部请求，而Interceptor只能拦截Controller的请求，因此从覆盖范围来看，Filter应用更广一些。可是在Spring逐渐一统Java框架、先后端分离越演越烈，实际上大部分的应用场景，拦截器均可以知足了。前后端分离