Java中过滤器 (Filter) 和 拦截器 (Interceptor)的使用

Java中的过滤器(Filter)和拦截器(Interceptor)是Web开发中常用的两个概念，它们能够有效地对请求进行处理和控制。在本文中，我们将针对Java中过滤器和拦截器的使用进行详细讲解，包括二者的区别、使用方法、作用范围等内容，并举例说明。

一、过滤器(Filter)和拦截器(Interceptor)的区别

过滤器(Filter)和拦截器(Interceptor)在作用上有一定的区别。简单来说，拦截器的作用范围更广，它可以作用于Action或Controller，也可以作用于拦截前或拦截后；而过滤器只能作用于Servlet，不能拦截包括jsp在内的其他静态页面。

二、过滤器（Filter）的使用

Java中的过滤器(Filter)是Servlet规范提供的一种机制，用于在Servlet容器中对请求进行过滤，例如，可以在请求到达Servlet之前进行过滤，并对请求进行修改，或者在请求返回浏览器之前处理返回数据。

以下是过滤器示例代码：

@WebFilter(urlPatterns = {"/*"})
public class MyFilter implements Filter {

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        System.out.println("过滤器初始化");
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        System.out.println("开始过滤");
        //执行下一个过滤器或servlet
        chain.doFilter(request, response);
        System.out.println("过滤结束");
    }

    @Override
    public void destroy() {
        System.out.println("过滤器销毁");
    }
}

这段代码中，我们通过使用@WebFilter注解定义了过滤器匹配的URL模式，上述配置会拦截所有URL映射，然后对请求进行处理。

三、拦截器（Interceptor）的使用

拦截器是SpringMVC框架提供的一种基于AOP的调用前、调用后或出现异常时进行拦截和处理的机制。它比Web中的Filter更加灵活，可以定义在Controller中，或者是定义在Spring Web应用程序中。

我们可以通过实现HandlerInterceptor接口实现拦截器，以下是拦截器示例代码：

public class MyInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("开始拦截");
        return true;
    }


    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("拦截结束");
    }


    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("处理完成");
    }
}

在上面的示例代码中，我们通过实现HandlerInterceptor接口，重写preHandle、postHandle、afterCompletion方法来实现对请求的拦截和处理。通过preHandle方法可以定义拦截前的逻辑，例如登录验证、权限控制等内容；postHandle方法可以定义拦截后的处理逻辑，例如页面跳转、日志记录、数据处理等内容；afterCompletion方法可以定义请求处理完成后的逻辑，例如资源回收、日志记录等内容。

四、示例说明

示例1：过滤器和拦截器的交替使用

在实际项目中，我们通常会同时使用过滤器和拦截器对请求进行处理。拦截器可以拦截Controller请求并处理一些业务逻辑，然后将请求转发给相应的过滤器。

以下是示例代码，使用拦截器和过滤器配合实现对Controller的拦截和处理：

@Configuration
public class InterceptorConfig implements WebMvcConfigurer {

    @Autowired
    private MyInterceptor myInterceptor;

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(myInterceptor).addPathPatterns("/**");
    }

    @Bean
    public FilterRegistrationBean testFilterRegistration() {
        FilterRegistrationBean registration = new FilterRegistrationBean();
        registration.setFilter(new MyFilter());
        registration.addUrlPatterns("/*");
        registration.setName("MyFilter");
        registration.setOrder(1);
        return registration;
    }
}

在上述代码中，我们通过addInterceptors()方法将拦截器MyInterceptor添加到拦截器配置中，并使用addPathPatterns()方法匹配所有请求；然后通过testFilterRegistration()方法定义了一个过滤器，并调用addUrlPatterns()方法设置过滤器的匹配模式。

示例2：拦截器的返回值控制请求的响应

拦截器中的返回值可以控制请求响应是否继续执行。当拦截器返回false时，就不会继续执行后面的逻辑；而返回true时，才会继续执行后面的逻辑。

以下是示例代码：

public class ResponseInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        int code = Integer.parseInt(request.getParameter("code"));
        if (code == 0) {
            response.getWriter().write("无权限");
            return false;
        }
        return true;
    }
}

在上述代码中，我们通过preHandle方法获取请求参数中的数字代码，如果代码为0，则返回无权限提示，并返回false，阻止请求继续执行。否则返回true，允许请求执行。这可以有效地实现对请求的权限控制。

五、结论

本文详细讲解了Java中过滤器(Filter)和拦截器(Interceptor)的使用方法，并举例说明了如何在实际项目中使用。过滤器(Filter)和拦截器(Interceptor)能够对请求进行有效的过滤、拦截和处理，可以在项目开发中发挥重要作用。