拦截器与过滤器：如何轻松拦截你的 HTTP 请求

2024-01-19 18:47:52

拦截器与过滤器：Spring MVC 中拦截 HTTP 请求的利器

引言

在 Spring MVC 的架构中，拦截器和过滤器扮演着至关重要的角色，它们共同负责拦截 HTTP 请求并在其处理过程中执行特定操作。本文将深入探讨这两种拦截机制之间的区别和适用场景，并辅以示例代码，帮助你全面理解它们在 Spring MVC 中的应用。

什么是拦截器？

拦截器是一个接口，它定义了一个方法：preHandle()。preHandle() 方法会在请求处理之前执行，为检查请求参数、设置请求属性、重定向请求等操作提供了机会。

拦截器的用途

拦截器通常用于执行以下任务：

验证请求参数的有效性
设置请求属性，例如当前登录的用户或语言偏好
根据业务逻辑重定向请求
记录请求日志

什么是过滤器？

过滤器也是一个接口，它定义了两个方法：doFilter() 和 destroy()。doFilter() 方法会在请求处理前和后执行，而 destroy() 方法会在过滤器销毁时执行。

过滤器的用途

过滤器主要用于以下目的：

压缩或解压缩请求和响应数据
加密或解密请求和响应数据
控制请求的访问权限，例如通过基于角色的访问控制
记录请求日志

拦截器与过滤器的区别

虽然拦截器和过滤器都用于拦截 HTTP 请求，但它们之间存在一些关键差异：

执行时机： 拦截器仅在请求处理之前执行，而过滤器在请求处理前和后都会执行。
拦截范围： 拦截器只能拦截控制器方法的请求，而过滤器可以拦截所有请求，包括静态资源和错误请求。
复杂性： 拦截器通常用于执行较简单的任务，而过滤器可以处理更复杂的逻辑。

何时使用拦截器或过滤器

选择使用拦截器或过滤器取决于你希望在请求处理过程中执行的任务的复杂程度和范围。

使用拦截器： 当需要在请求处理之前执行简单的操作时，例如验证参数或设置属性。
使用过滤器： 当需要在请求处理前和后执行更复杂的逻辑时，例如压缩数据或控制访问权限。

示例代码

以下示例代码展示了如何使用拦截器和过滤器：

拦截器

public class MyInterceptor implements Interceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        // 检查请求参数的有效性
        if (!isValidRequest(request)) {
            // 重定向请求
            response.sendRedirect("/error");
            return false;
        }

        // 设置请求属性
        request.setAttribute("username", "admin");

        // 继续处理请求
        return true;
    }

    private boolean isValidRequest(HttpServletRequest request) {
        // TODO: 检查请求参数的有效性
        return true;
    }
}

过滤器

public class MyFilter implements Filter {

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain) throws IOException, ServletException {
        // 在请求处理之前执行
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        HttpServletResponse httpResponse = (HttpServletResponse) response;

        // 检查请求参数的有效性
        if (!isValidRequest(httpRequest)) {
            // 重定向请求
            httpResponse.sendRedirect("/error");
            return;
        }

        // 设置请求属性
        httpRequest.setAttribute("username", "admin");

        // 继续处理请求
        chain.doFilter(request, response);

        // 在请求处理之后执行
    }

    private boolean isValidRequest(HttpServletRequest request) {
        // TODO: 检查请求参数的有效性
        return true;
    }

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // TODO: 初始化过滤器
    }

    @Override
    public void destroy() {
        // TODO: 销毁过滤器
    }
}