探索 Spring 中的拦截器：实现请求处理的灵活性-CSDN博客

本文链接：https://blog.csdn.net/qq_51321722/article/details/141093747

在 Spring 框架中，拦截器（Interceptor）是处理 Web 请求的一个强大工具。它们可以在请求到达目标处理器之前和响应返回之前对请求和响应进行预处理和后处理。本文将深入探讨 Spring 中的拦截器，包括它们的工作原理、使用方式以及常见的应用场景。

什么是 Spring 拦截器？

Spring 拦截器是实现 HandlerInterceptor 接口的组件。它们允许你在 Spring MVC 的处理链中插入自定义逻辑，以便在请求到达控制器之前或响应离开控制器之后进行处理。拦截器类似于 Servlet 的过滤器，但它们更紧密地集成在 Spring 的处理流程中，并提供了更多的控制和灵活性。

拦截器的工作流程

在 Spring MVC 中，请求处理的流程大致如下：

请求到达 DispatcherServlet：所有的请求都首先由 DispatcherServlet 处理。
拦截器链的处理：DispatcherServlet 会调用配置的拦截器链。
处理器映射：找到并调用对应的处理器（Controller）。
视图解析：处理器返回一个 ModelAndView 对象，视图解析器根据它生成视图。
拦截器链的后处理：视图渲染之前，拦截器会对响应进行处理。

在这个过程中，拦截器的作用主要体现在以下几个阶段：

preHandle：在请求到达处理器之前调用。
postHandle：在处理器处理完请求后，但在视图渲染之前调用。
afterCompletion：在视图渲染之后调用，用于处理清理工作。

实现一个拦截器

要实现一个 Spring 拦截器，你需要创建一个类实现 HandlerInterceptor 接口，并重写其三个方法：preHandle、postHandle 和 afterCompletion。下面是一个简单的拦截器示例：

import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class MyInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("Pre-handle: " + request.getRequestURI());
        return true; // 返回 true 继续处理请求，返回 false 则阻止后续处理
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("Post-handle: " + request.getRequestURI());
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("After completion: " + request.getRequestURI());
    }
}

配置拦截器

拦截器的配置可以通过 Java 配置类或 XML 配置文件进行。

Java 配置方式

在 Java 配置类中，可以通过实现 WebMvcConfigurer 接口，并重写 addInterceptors 方法来注册拦截器：

import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(new MyInterceptor())
                .addPathPatterns("/**"); // 设定拦截的 URL 模式
    }
}

XML 配置方式

在 XML 配置中，可以通过 <mvc:interceptors> 元素来注册拦截器：

<mvc:interceptors>
    <bean class="com.example.MyInterceptor" />
</mvc:interceptors>

常见应用场景

日志记录：记录请求和响应的信息，方便调试和监控。
权限检查：检查用户的权限，确保请求的合法性。
性能监控：记录请求的处理时间，帮助优化性能。
全局数据处理：在请求处理过程中添加或修改数据。

总结

Spring 拦截器是 Web 开发中的一个重要工具，它们提供了一种灵活的方式来处理请求和响应。通过实现 HandlerInterceptor 接口并在配置中注册拦截器，你可以在请求处理链的不同阶段插入自定义逻辑，从而增强应用程序的功能和可维护性。

了解和掌握 Spring 拦截器的使用，将有助于你更好地控制和管理 Web 应用程序的行为，提高开发效率和应用程序的质量。

拦截器与过滤器