过滤器与拦截器的区分,一文读懂

后端

2023-01-02 21:18:25

Spring Boot 中的过滤器与拦截器：全面解析

在构建 web 应用程序时，我们经常需要处理诸如安全检查、日志记录和请求验证之类的任务。Spring Boot 提供了两种强大的机制来实现这些目标：过滤器和拦截器。

过滤器：HTTP 请求和响应的守护者

过滤器是 Java EE 中用来处理 HTTP 请求和响应的组件。它们可以在请求到达 servlet 或 JSP 页面之前，或者在响应被发送到客户端之前进行处理。

工作原理：

过滤器通过实现 javax.servlet.Filter 接口来工作。当请求到达应用程序时，过滤器会首先进行处理。如果过滤器允许该请求继续，它将继续被 servlet 或 JSP 页面处理。否则，请求将被过滤器拦截并返回。

优点：

可以处理所有请求，无论是否路由到控制器方法。
可以使用注解或 XML 配置进行配置。

缺点：

无法访问控制器方法的参数和返回值。
无法访问模型和视图对象。

拦截器：控制器方法的保镖

拦截器也是 Java EE 组件，用于处理 HTTP 请求和响应。它们可以在请求到达控制器方法之前或在控制器方法执行后进行处理。

工作原理：

拦截器通过实现 org.springframework.web.servlet.HandlerInterceptor 接口来工作。当请求到达控制器方法之前，拦截器会首先进行处理。如果拦截器允许该请求继续，它将继续被控制器方法处理。否则，请求将被拦截器拦截并返回。

优点：

可以访问控制器方法的参数和返回值。
可以访问模型和视图对象。

缺点：

只能处理路由到控制器方法的请求。
只能使用注解配置。

使用场景：

过滤器 通常用于对请求和响应进行预处理或后处理，例如：

编码/解码
压缩/解压缩
安全检查
日志记录

拦截器 通常用于处理控制器方法的执行，例如：

权限检查
性能监控
事务管理

代码示例：

// 过滤器示例
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;

public class SimpleFilter implements Filter {

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        System.out.println("请求 URI： " + httpRequest.getRequestURI());
        chain.doFilter(request, response);
    }

}

// 拦截器示例
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

public class SimpleInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("拦截器 preHandle 方法被调用");
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("拦截器 postHandle 方法被调用");
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("拦截器 afterCompletion 方法被调用");
    }

}