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拦截器与过滤器区别内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • JAVA LinkedList和ArrayList的使用及性能分析

    JAVA LinkedList和ArrayList的使用及性能分析

    JAVA LinkedList和ArrayList的使用及性能分析,这篇文章也是以JAVA List的总结。
    2013-11-11
  • 详细谈谈Java中long和double的原子性

    详细谈谈Java中long和double的原子性

    原子性是指一个操作或多个操作要么全部执行,且执行的过程不会被任何因素打断,要么就都不执行,下面这篇文章主要给大家介绍了关于Java中long和double原子性的相关资料,需要的朋友可以参考下
    2021-08-08
  • mybatis调用存储过程的实例代码

    mybatis调用存储过程的实例代码

    这篇文章主要介绍了mybatis调用存储过程的实例,非常不错,具有参考借鉴价值,需要的朋友可以参考下
    2017-10-10
  • IntelliJ IDEA2020.1版本更新pom文件自动导包的方法

    IntelliJ IDEA2020.1版本更新pom文件自动导包的方法

    这篇文章主要介绍了IntelliJ IDEA2020.1版本更新pom文件自动导包的方法,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-06-06
  • springAop实现权限管理数据校验操作日志的场景分析

    springAop实现权限管理数据校验操作日志的场景分析

    这篇文章主要介绍了springAop实现权限管理数据校验操作日志的场景分析,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2021-03-03
  • 使用Spring开启注解AOP的支持放置的位置

    使用Spring开启注解AOP的支持放置的位置

    这篇文章主要介绍了使用Spring开启注解AOP的支持放置的位置,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2021-09-09
  • Java经典设计模式之策略模式原理与用法详解

    Java经典设计模式之策略模式原理与用法详解

    这篇文章主要介绍了Java经典设计模式之策略模式,简单说明了策略模式的概念、原理并结合实例形式分析了java策略模式的具有用法与相关注意事项,需要的朋友可以参考下
    2017-08-08
  • @JsonProperty和@JSONField注解的区别解析(最新)

    @JsonProperty和@JSONField注解的区别解析(最新)

    Jackson是一款优秀的JSON解析库,添加了依赖之后就可以使用对应的注解,让我们能够自由的将Java对象和JSON做转换,这篇文章主要介绍了@JsonProperty和@JSONField注解的区别,需要的朋友可以参考下
    2024-04-04
  • Java NIO实现聊天功能

    Java NIO实现聊天功能

    这篇文章主要为大家详细介绍了Java NIO实现聊天功能,文中示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-11-11
  • Spring基于注解读取外部配置文件

    Spring基于注解读取外部配置文件

    这篇文章主要介绍了Spring基于注解读取外部配置文件,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-12-12

最新评论