怎样使用java拦截器

在 Java 中，“拦截器（Interceptor）”常见于 Web 开发（如 Spring、Spring MVC） 和 MyBatis 等框架中。下面我按最常见场景给你讲解，特别是 Spring 中的拦截器。

一、Spring MVC 中使用拦截器（最常用）

1️⃣ 创建拦截器类

实现 HandlerInterceptor 接口：

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

public class LoginInterceptor implements HandlerInterceptor {

    // 控制器方法执行之前
    @Override
    public boolean preHandle(HttpServletRequest request,
                             HttpServletResponse response,
                             Object handler) throws Exception {
        System.out.println("请求前拦截");
        // return true 放行，false 拦截
        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("请求完成");
    }
}

2️⃣ 注册拦截器

在配置类中注册（Spring Boot）：

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 LoginInterceptor())
                .addPathPatterns("/**")      // 拦截所有
                .excludePathPatterns("/login"); // 排除登录
    }
}

✅ 这样所有请求都会经过拦截器。

二、拦截器执行顺序

请求 → preHandle → Controller → postHandle → afterCompletion

• preHandle 返回 false：请求直接结束
• 常用于：登录校验、权限控制、日志记录

三、MyBatis 拦截器（了解）

MyBatis 使用 Interceptor 接口：

@Intercepts({
    @Signature(type = Executor.class,
               method = "update",
               args = {MappedStatement.class, Object.class})
})
public class MyBatisInterceptor implements Interceptor {
    @Override
    public Object intercept(Invocation invocation) throws Throwable {
        System.out.println("SQL 执行前");
        return invocation.proceed();
    }
}

四、拦截器 vs 过滤器

五、常见使用场景

• 登录验证
• 权限校验
• 接口日志
• 接口耗时统计
• 防重复提交

如果你用的是 Spring Boot / Spring Cloud / Struts2 / WebFlux，可以告诉我，我可以给你对应示例。