如何自定义java拦截器

在 Java 中，“拦截器”常见于 Spring MVC 拦截器、MyBatis 拦截器、Servlet Filter 等场景。下面我以最常用、最标准的 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 {
        Object user = request.getSession().getAttribute("user");
        if (user == null) {
            response.sendRedirect("/login");
            return false; // 拦截
        }
        return true; // 放行
    }

    // 控制器方法执行之后
    @Override
    public void postHandle(HttpServletRequest request,
                           HttpServletResponse response,
                           Object handler,
                           ModelAndView modelAndView) throws Exception {
    }

    // 整个请求完成后
    @Override
    public void afterCompletion(HttpServletRequest request,
                                HttpServletResponse response,
                                Object handler,
                                Exception ex) throws Exception {
    }
}

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

三、Servlet Filter（更底层）

如果你想要更底层拦截（如字符编码、XSS）：

@WebFilter("/*")
public class MyFilter implements Filter {
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain chain)
            throws IOException, ServletException {
        // 前置处理
        chain.doFilter(req, res);
        // 后置处理
    }
}

四、MyBatis 拦截器（SQL 层）

@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 {
        // 自定义逻辑
        return invocation.proceed();
    }
}

五、常见使用场景

✅ 登录校验
✅ 权限控制
✅ 日志记录
✅ 接口耗时统计
✅ 参数/响应处理

如果你能告诉我：

• 用的是 Spring Boot / Spring MVC / Spring Cloud
• 拦截的是 Web 请求 / SQL / 方法调用

我可以给你更精准的示例。