拦截器和过滤器(理论+实操)

aristo_boyunv2025-09-08 20:47

拦截器和过滤器

本文旨在夯实基础以及实战加深理解,目的是更深的理解以便掌握,希望能跟着动手敲一遍,绝对受益匪浅

在本文,我会先给出两者的区别(理论知识),随后是两者各自的实操实现

文章目录

什么是过滤器和拦截器?

1.过滤器

首先说下什么是过滤器?

  1. 是Java Servlet规范中定义的标准 ,是Servlet一部分,
  2. 配置也是非常简单 ,直接实现javax.servlet.Filter接口就可以,
  3. 也可以用注解 @WebFilter对特定的URL拦截

2.拦截器

那拦截器又是什么东东?

  1. 是Spring框架自身 提供的组件,也就是说必须依赖SpringMvc框架才能使用,是位于Spring的上下文之中
  2. 是AOP的一种实现,支持链式调用 ,通过类HandlerInterceptor实现多个拦截
  3. 说白了:就是切面编程 典型实现,允许程序猿在一些核心业务 操作执行的前后 插入自定义的逻辑代码,如日志记录,权限认证等,而无需修改核心代码的本身

执行整体流程

我们首先看下过滤器和拦截器在整个流程中的执行顺序
请求进入 preHandle 调用Controller 返回ModelAndView postHandle/afterCompletion 返回响应 响应返回 HTTP Request Tomcat 容器 Filter 链 DispatcherServlet Interceptor 链 Controller HTTP Response

解释说明:(结合上图)

  1. Filter 开始 ：HTTP 请求进入 Tomcat 容器。
  2. Filter 链处理 ：请求会经过所有配置的 Filter 的 doFilter() 方法。
  3. 进入 Spring MVC ：请求到达 DispatcherServlet（Spring MVC 的核心控制器）。
  4. Interceptor 开始 ：DispatcherServlet 分发请求前，会先执行拦截器链的 preHandle 方法。
  5. Controller 执行 ：如果 preHandle 返回 true，请求被分发到对应的 Controller 方法执行。
  6. Interceptor 后处理 ：
    • Controller 执行完毕后，返回 ModelAndView，然后执行拦截器链的 postHandle 方法。
    • 视图渲染完毕后（或请求处理完成后），执行拦截器链的 afterCompletion 方法。
  7. Filter 结束 ：响应最终再次经过 Filter 链的 doFilter() 方法（反向），返回给客户端。

拦截器和过滤器的区别

特性 过滤器 (Filter) 拦截器 (Interceptor)
归属与依赖 Servlet 规范，不依赖 Spring Spring 框架 的组件
作用范围 作用于所有进入容器的请求（包括静态资源，如 /css/, /js/） 只作用于 Spring MVC 处理的请求（即 Controller 的请求，通常不会拦截静态资源）
实现原理 基于 函数回调 (doFilter()) 基于 Java 反射和动态代理
使用方式 在 web.xml 中配置或使用 @WebFilter 注解 在 Spring MVC 配置中注册 (WebMvcConfigurer)
获取 IOC 容器 无法 直接获取 Spring 的 IOC 容器和其中的 Bean 可以 ，因为它本身就是 Spring 管理的，可以轻松使用 @Autowired 注入其他 Bean
执行时机/位置 最早 。 1. 在请求进入 Tomcat 等容器 之后 2. 在进入 Servlet 之前 3. 在 Servlet 处理完之后，返回给客户端之前 较晚 。 1. 在请求进入 DispatcherServlet 之后 2. 在进入 Controller 之前 (preHandle ) 3. 在 Controller 执行之后，视图渲染之前 (postHandle ) 4. 在整个请求结束之后 (afterCompletion)
功能侧重 更底层，关注的是请求本身（Request/Response），功能强大。 例如：字符编码设置、权限校验（粗粒度）、日志记录、性能监控、解压/gzip压缩。 更上层，关注的是 Controller 的方法执行，与业务结合更紧密。 例如：更精细的权限校验（判断Token、角色）、日志记录（记录Controller方法、参数）、参数预处理、Controller 执行时间计算。

实操:

1.过滤器

案例: 在Springboot中实现日志记录过滤器

1.定义日志记录过滤器类LogFilter

主要的三大核心 方法:(可以结合上面的整体执行流程图来看)

  • init() ：该方法在容器启动初始化 过滤器时被调用 ，在 Filter 的整个生命周期只会被调用一次 。注意 ：这个方法必须执行成功，否则过滤器不生效,没有作用。
  • doFilter() ：容器中的每一次请求 都会调用该方法， FilterChain 用来调用下一个 过滤器 Filter。
  • destroy()： 当容器销毁 过滤器实例时调用该方法，一般在方法中销毁或关闭资源，在过滤器 Filter 的整个生命周期也只会被调用一次
java 复制代码 
package com.zhengqian.test01aop.filter;

import lombok.extern.slf4j.Slf4j;

import javax.servlet.*;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;
import java.io.IOException;

/**
 * 日志过滤器: 
 * @author zhengqian
 * @since 2025年09月04日 14:56
 */
@WebFilter(urlPatterns = "/*")//过滤所有的请求
@Slf4j
public class LogFilter implements Filter {
    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        Filter.super.init(filterConfig);
        //初始化执行
        log.info("***^^^日志过滤器初始化完成");
    }

    @Override
    public void doFilter(ServletRequest servletRequest, ServletResponse servletResponse, FilterChain filterChain) throws IOException, ServletException {
        //记录请求的开始时间
        long startTime = System.currentTimeMillis();
        //转换为HttpServletRequest获取更多信息
        HttpServletRequest httpServletRequest = (HttpServletRequest) servletRequest;
        //获取基本信息
        String requestURI = httpServletRequest.getRequestURI();
        String method = httpServletRequest.getMethod();
        String remoteAddr = httpServletRequest.getRemoteAddr();
        //
        log.info("请求开始=> 方法:{} 路径: {}} IP:{}",method,requestURI,remoteAddr);

        try {
            filterChain.doFilter(servletRequest,servletResponse);
        } finally {
            //计算处理耗时
            long duration = System.currentTimeMillis() - startTime;
            //响应日志
            log.info("请求结束 ==> 路径: {} 耗时:{}",requestURI,duration);
        }
    }

    @Override
    public void destroy() {
        Filter.super.destroy();
        log.info("日志过滤器销毁");
    }
}
2.在主启动类上添加注解 @ServletComponentScan

OK!这个时候你启动就可以看到此过滤器成功!

你可能会问?这么简单?对的,就是这么简单!前提你要跟着做!哈哈哈!

2.拦截器

1.创建拦截器

核心方法解释:

  • preHandle() ：
    • 此方法在请求处理之前进行调用。
    • 注意 ：如果该方法的返回值为false ，将视为当前请求结束 ，不仅自身 的拦截器 会失效，还会导致其他的拦截器也不再执行。
  • postHandle()：
    • 只有在 preHandle() 方法返回值为true 时才会执行。
    • 会在Controller 中的方法调用之后，DispatcherServlet 返回渲染视图之前被调用。
  • afterCompletion()：只有在 preHandle() 方法返回值为true 时才会执行。在整个请求结束 之后， DispatcherServlet 渲染了对应的视图之后执行。
java 复制代码 
package com.zhengqian.test01aop.interceptor;

import lombok.extern.slf4j.Slf4j;
import org.springframework.web.method.HandlerMethod;
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

/**
 * 自定义拦截器的实现
 * @author zhengqian
 * @since 2025年09月04日 15:13
 */
@Slf4j
public class CustomInterceptor implements HandlerInterceptor {



    /**
     * 请求处理前被调用
     * @param request 请求
     * @param response 响应
     * @param handler 处理器
     * @return  aa
     * @throws Exception
     */
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        //添加校验权限
        log.info("开始出发拦截器校验前的处理------------->");
        return true;
    }

    /**
     * **其中**：`postHandle()` 方法被调用的顺序跟 `preHandle()` 是**相反**的，先声明的拦截器  `preHandle()` 方法先执行，而`postHandle()`方法反而会后执行。
     * @throws Exception
     */
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        log.info("只有在 preHandle() 方法返回值为true 时才会执行");
        HandlerInterceptor.super.postHandle(request, response, handler, modelAndView);
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        log.info("整个请求结束之后被调用");
        HandlerInterceptor.super.afterCompletion(request, response, handler, ex);
    }


}
2.注册拦截器

addPathPatterns:需要拦截的路径

excludePathPatterns: 不需要拦截的路径

java 复制代码 
package com.zhengqian.test01aop.config;

import com.zhengqian.test01aop.interceptor.CustomInterceptor;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;

/**
 * @author zhengqian
 * @since 2025年09月04日 15:19
 */
@Configuration
public class WebConfig implements WebMvcConfigurer {

    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        //注册拦截器并设置拦截路径
        registry.addInterceptor(new CustomInterceptor())
            	//拦截所有
                .addPathPatterns("/**")
            	//排除*/login的登录路径
                .excludePathPatterns("/aop/login");
    }
}
测试

我们建一个测试类,来进行上面的拦截测试

java 复制代码 
package com.zhengqian.test01aop.controller;

import com.zhengqian.test01aop.service.TestService;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RestController;

import javax.annotation.Resource;

/**
 * @author zhengqian
 * @date 2025年07月21日 16:40
 */
@RestController
@RequestMapping("/aop")
public class TestController {
    @Resource
    TestService testService;

    @GetMapping("/test")
    public  String test(){
        testService.test();
        return "测试成功!----";
    }

    @GetMapping("/login")
    public  String login(){
        testService.test();
        return "测试成功!----";
    }
}

打印日志:

1.走拦截器


好了,你学会没?

相关推荐
程序员小假21 小时前
我们来说一说 ThreadLocal 内存泄漏
java·后端
xq952721 小时前
获取Facebook 散列利器 来了 十六进制到 Base64 转换器
java
IT研究室21 小时前
大数据毕业设计选题推荐-基于大数据的青光眼数据可视化分析系统-大数据-Spark-Hadoop-Bigdata
大数据·hadoop·信息可视化·spark·毕业设计·源码·bigdata
我不是混子21 小时前
聊聊Spring事件机制
java·后端
DKPT21 小时前
JVM栈溢出时如何dump栈信息？
java·jvm·笔记·学习·spring
DKPT21 小时前
JVM堆大小如何设置？
java·开发语言·jvm·笔记·学习
铅笔侠_小龙虾21 小时前
JVM 目录
java·jvm
yunxi_0521 小时前
让大模型会“说话”：基于 Spring WebSocket 的毫秒级流式 RAG 对话
java·后端
用户6120414922131 天前
jsp+servlet做的医院挂号看诊管理系统
java·javascript·mysql
€8111 天前
Java入门级教程21——Java 缓存技术、RMI远程方法调用、多线程分割大文件
java·开发语言·java缓存代理模式的实现·java rmi远程方法调用·多线程分割大文件
热门推荐
01GitHub 镜像站点02UV 工具安装与国内镜像源配置指南03UV安装并设置国内源04OpenSpeedy简介05阿里最新开源Wan2.2-Animate-14B 本地部署教程：统一双模态框架，MoE架构赋能电影级角色动画与替换06Spec-Kit 使用指南07Linux下V2Ray安装配置指南08KGG转MP3工具|非KGM文件|解密音频0946个Nano-banana 精选提示词，持续更新中10VsCode远程Copilot无法使用Claude Agent问题