Spring 框架中拦截器与过滤器的区别及拦截器使用详解

 更新时间:2025年06月19日 11:11:57   作者:大智若愚Null  
过滤器和拦截器在Spring开发中各有优势,过滤器适用于处理通用的请求处理任务,而拦截器更适合与业务逻辑紧密相关的操作,本文给大家介绍Spring 框架中拦截器与过滤器的区别及拦截器使用详解,感兴趣的朋友一起看看吧

Spring 框架中拦截器与过滤器的区别及拦截器使用详解

在 Spring 框架的开发过程中,拦截器和过滤器都是非常重要的组件,它们都可以对请求进行拦截和处理,但在实现原理、应用场景等方面存在明显差异。本文将深入剖析两者的区别,并通过详细的代码示例介绍 Spring 拦截器的使用步骤。

一、拦截器与过滤器的区别

1.1 所属体系与运行环境

  • 过滤器(Filter):是 Servlet 规范的一部分,由 Web 容器(如 Tomcat)管理,在 Servlet 容器启动时加载,不依赖 Spring 框架,可独立于 Spring 运行 。例如,在传统的 Servlet 项目中,也可以使用过滤器进行请求处理。

  • 拦截器(Interceptor):是 Spring 框架的组件,依托于 Spring 容器,只有在 Spring 环境下才能发挥作用。它随着 Spring 容器的启动而初始化,在 Spring MVC 的请求处理流程中发挥作用。

1.2 拦截范围

  • 过滤器:可以拦截所有进入 Web 容器的请求,包括静态资源(如 CSS、JS 文件)请求和 Servlet 请求。例如,对所有请求进行统一的字符编码设置,就可以使用过滤器实现。

  • 拦截器:仅针对 Spring MVC 的 Controller 请求生效,对静态资源等非 Controller 请求不起作用。比如,当我们只想对业务接口进行权限校验时,拦截器就更合适。

1.3 执行时机与方法

  • 过滤器:通过实现Filter接口,重写init、doFilter和destroy方法来完成功能。doFilter方法在请求到达 Servlet 之前被调用,主要用于请求的预处理,如设置请求头、修改请求参数等 。

  • 拦截器:实现HandlerInterceptor接口,有三个关键方法:

  • preHandle:在 Controller 方法调用前执行,返回true表示继续执行后续流程,返回false则中断请求 。

  • postHandle:在 Controller 方法调用后、视图渲染前执行,可以对 ModelAndView 进行修改 。

  • afterCompletion:在整个请求完成后执行,常用于资源清理、记录日志等操作 。

1.4 功能与灵活性

  • 过滤器:功能相对基础,主要用于处理一些通用的、与业务逻辑无关的操作,如解决跨域问题、设置请求编码格式等。

  • 拦截器:功能更为强大和灵活,能更精细地控制请求处理流程,可在请求处理的不同阶段介入,适合处理与业务逻辑相关的操作,如权限验证、性能监控等。

二、Spring 拦截器使用步骤

  • 接下来,以 Spring Boot 项目为例,详细介绍拦截器的使用方法,并提供完整的代码示例。

2.1 创建拦截器类

  • 创建一个实现HandlerInterceptor接口的类,并重写三个核心方法。这里创建一个简单的权限验证拦截器AuthInterceptor:
//被扫描
@Component
public class LoginInterceptor implements HandlerInterceptor {
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        System.out.println("preHandle Interceptor");
//        return可返回两种值  : true  拦截放行   false  拦截不放行
        //判断用户是否登录,获取Session中存的会话
        Object username = request.getSession().getAttribute("username");
        //username == null  说明username未存入会话,用户没有登录
        if (username != null){
            System.out.println("已登录");
            return true;
        }
        //向前端发出响应
        response.getWriter().write("notlogin");
        return false;
    }
    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        System.out.println("postHandle Interceptor");
    }
    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        System.out.println("afterCompletion Interceptor");
    }
}

2.2 配置拦截器

  • 创建一个配置类,实现WebMvcConfigurer接口,重写addInterceptors方法来注册拦截器,并指定拦截路径和排除路径。
@Configuration
@EnableWebMvc
public class SpringMvc implements WebMvcConfigurer {
    @Autowired
    private LoginInterceptor loginInterceptor;
//    拦截器拦截路径和排除路径
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(loginInterceptor).addPathPatterns("/api");
    }
}

2.3 测试拦截器

  • 创建一个简单的 Controller 用于测试拦截器的效果
@RestController
@RequestMapping("/api")
public class apiController {
    @GetMapping
    public String login() {
        System.out.println("Controller!");
        return "登录成功";
    }

三、总结

过滤器和拦截器在 Spring 开发中各有优势,过滤器适用于处理通用的请求处理任务,而拦截器更适合与业务逻辑紧密相关的操作。掌握它们的区别和使用方法,能帮助我们更高效地开发健壮、可维护的 Web 应用。

到此这篇关于Spring 框架中拦截器与过滤器的区别及拦截器使用详解的文章就介绍到这了,更多相关Spring拦截器与过滤器区别内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • mybatis-plus分页无效问题解决

    mybatis-plus分页无效问题解决

    本文主要介绍了mybatis-plus分页无效问题解决,原因是配置分页插件的版本问题,旧版本和新版本的MyBatis-Plus需要不同的分页配置,感兴趣的可以了解一下
    2025-03-03
  • Java监听器ActionListener与MouseListener的执行顺序说明

    Java监听器ActionListener与MouseListener的执行顺序说明

    这篇文章主要介绍了Java监听器ActionListener与MouseListener的执行顺序说明,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-12-12
  • Java中的BigDecimal原理详解

    Java中的BigDecimal原理详解

    这篇文章主要介绍了Java中的BigDecimal原理详解,对于日常开发过程中出现小数的问题,通常都是使用float或者double类型来处理,在java中float占用四个字节, double类型占用8个字节,需要的朋友可以参考下
    2023-09-09
  • springboot 运行 jar 包读取外部配置文件的问题

    springboot 运行 jar 包读取外部配置文件的问题

    这篇文章主要介绍了springboot 运行 jar 包读取外部配置文件,本文主要描述linux系统执行jar包读取jar包同级目录的外部配置文件,主要分为两种方法,每种方法通过实例代码介绍的非常详细,需要的朋友可以参考下
    2021-07-07
  • Mybatis saveAndUpdate空值不更新问题及解决

    Mybatis saveAndUpdate空值不更新问题及解决

    这篇文章主要介绍了Mybatis saveAndUpdate空值不更新问题及解决方案,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-02-02
  • SpringCloud整合分布式服务跟踪zipkin的实现

    SpringCloud整合分布式服务跟踪zipkin的实现

    这篇文章主要介绍了SpringCloud整合分布式服务跟踪zipkin的实现,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2019-09-09
  • Java SpringBoot安全框架整合Spring Security详解

    Java SpringBoot安全框架整合Spring Security详解

    这篇文章主要介绍了Spring Boot整合Spring Security的示例代码,小编觉得挺不错的,现在分享给大家,也给大家做个参考。一起跟随小编过来看看吧
    2021-09-09
  • Java连接SQL Server数据库的超详细教程

    Java连接SQL Server数据库的超详细教程

    在Java应用程序中我们经常需要与数据库进行交互,一种常见的数据库是Microsoft SQL Server,下面这篇文章主要给大家介绍了关于Java连接SQL Server数据库的超详细教程,需要的朋友可以参考下
    2024-01-01
  • SpringBoot项目URL访问异常的问题处理

    SpringBoot项目URL访问异常的问题处理

    这篇文章主要介绍了SpringBoot项目URL访问异常的问题处理方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-07-07
  • spring中@Bean和@Component的区别及说明

    spring中@Bean和@Component的区别及说明

    文章主要介绍了@Bean和@Component两个注解在Spring框架中的定义、作用范围、创建方式、扫描和识别机制以及使用场景和建议
    2024-12-12

最新评论