拦截器和过滤器的区别

拦截器(Interceptor)和过滤器(Filter)都是用于在请求处理过程中进行预处理和后处理的组件,但它们在实现原理、使用场景和功能特点上有显著区别。

拦截器和过滤器的区别

1. 基本概念

过滤器(Filter)

  • 基于函数回调的Java Web组件
  • 实现了Servlet规范,是Servlet技术的一部分
  • 依赖于Servlet容器(如Tomcat)
  • 可以对所有进入容器的请求进行处理

拦截器(Interceptor)

  • 基于Java反射机制的组件
  • 是Spring框架的一部分(Spring MVC中)
  • 不依赖Servlet容器,依赖Spring容器
  • 主要用于拦截Controller层的请求

2. 执行顺序

scss 复制代码
客户端请求
    ↓
Filter1 (前置处理)
    ↓
Filter2 (前置处理)
    ↓
DispatcherServlet
    ↓
Interceptor1 (preHandle)
    ↓
Interceptor2 (preHandle)
    ↓
Controller方法执行
    ↓
Interceptor2 (postHandle)
    ↓
Interceptor1 (postHandle)
    ↓
视图渲染
    ↓
Interceptor2 (afterCompletion)
    ↓
Interceptor1 (afterCompletion)
    ↓
Filter2 (后置处理)
    ↓
Filter1 (后置处理)
    ↓
返回客户端响应

3. 功能对比

特性 过滤器(Filter) 拦截器(Interceptor)
实现原理 基于函数回调 基于Java反射机制
依赖容器 Servlet容器 Spring容器
触发时机 请求进入容器时 请求进入Controller前
拦截范围 所有请求 DispatcherServlet处理的请求
配置方式 web.xml或注解 Spring配置或注解
访问Servlet API 可以直接访问 通过参数访问

4. 代码示例

过滤器示例

java 复制代码
@Component
@WebFilter(urlPatterns = "/*", filterName = "authFilter")
public class AuthFilter implements Filter {
    
    @Override
    public void doFilter(ServletRequest request, ServletResponse response, 
                        FilterChain chain) throws IOException, ServletException {
        
        HttpServletRequest httpRequest = (HttpServletRequest) request;
        HttpServletResponse httpResponse = (HttpServletResponse) response;
        
        // 前置处理
        String token = httpRequest.getHeader("Authorization");
        System.out.println("Filter前置处理: " + httpRequest.getRequestURI());
        
        // 继续执行过滤器链
        chain.doFilter(request, response);
        
        // 后置处理
        System.out.println("Filter后置处理: " + httpRequest.getRequestURI());
    }
}

拦截器示例

java 复制代码
@Component
public class AuthInterceptor implements HandlerInterceptor {
    
    @Override
    public boolean preHandle(HttpServletRequest request, 
                           HttpServletResponse response, 
                           Object handler) throws Exception {
        // 请求处理前执行
        System.out.println("Interceptor前置处理: " + request.getRequestURI());
        return true; // 返回true继续执行,false中断执行
    }
    
    @Override
    public void postHandle(HttpServletRequest request, 
                          HttpServletResponse response, 
                          Object handler, 
                          ModelAndView modelAndView) throws Exception {
        // 请求处理后、视图渲染前执行
        System.out.println("Interceptor后置处理: " + request.getRequestURI());
    }
    
    @Override
    public void afterCompletion(HttpServletRequest request, 
                              HttpServletResponse response, 
                              Object handler, 
                              Exception ex) throws Exception {
        // 整个请求完成后执行
        System.out.println("Interceptor完成处理: " + request.getRequestURI());
    }
}

5. 注册方式

过滤器注册

java 复制代码
// 方式1:使用@WebFilter注解
@WebFilter(urlPatterns = "/api/*")
public class MyFilter implements Filter { }

// 方式2:在配置类中注册
@Configuration
public class FilterConfig {
    
    @Bean
    public FilterRegistrationBean<MyFilter> loggingFilter() {
        FilterRegistrationBean<MyFilter> registrationBean = new FilterRegistrationBean<>();
        registrationBean.setFilter(new MyFilter());
        registrationBean.addUrlPatterns("/api/*");
        registrationBean.setOrder(1);
        return registrationBean;
    }
}

拦截器注册

java 复制代码
@Configuration
public class InterceptorConfig implements WebMvcConfigurer {
    
    @Autowired
    private AuthInterceptor authInterceptor;
    
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        registry.addInterceptor(authInterceptor)
                .addPathPatterns("/api/**")
                .excludePathPatterns("/api/login");
    }
}

6. 使用场景

过滤器适用场景

  • 字符编码设置
  • 跨域处理
  • 请求日志记录
  • 权限检查(粗粒度)
  • 请求/响应内容压缩

拦截器适用场景

  • 登录验证
  • 权限检查(细粒度)
  • 性能监控
  • 事务管理
  • 异常处理

7. 性能和开销

  • 过滤器:相对轻量,直接在Servlet容器层面处理,开销较小
  • 拦截器:需要Spring容器管理,会有一些反射调用开销,但功能更强大

两者可以根据具体需求选择使用,也可以结合使用以发挥各自优势。

相关推荐
考虑考虑15 分钟前
Springboot环境变量占位符语法
spring boot·后端·spring
步行cgn2 小时前
Spring 基于 XML 的自动装配:byName 详解
java·后端·spring
RISCV_Explorer4 小时前
RISC-V启动与运行时规范机制解析——BRS约定、HSM多核启动与设备树要求
后端·risc-v
星栈独行4 小时前
ADK-Rust 是什么?Rust 生态新一代 AI Agent 开发套件
人工智能·后端·rust
JavaGuide4 小时前
对标 MinIO!全新一代分布式文件系统正式发布
前端·后端
用户8356290780515 小时前
使用 Python 将 DOCX 转换为 Markdown
后端·python
IT_陈寒5 小时前
Vue computed属性这个坑,我居然踩了三次才爬出来
前端·人工智能·后端
孙启超6 小时前
【AI开发之Rust】第 7 课:错误处理 —— panic、Result 与 `?`
人工智能·分布式·后端·爬虫·spring cloud·架构·rust
烈风逍遥6 小时前
第一篇:SeaPack 全栈项目工程化实践
前端·后端·架构
烈风逍遥6 小时前
第二篇:SeaPack 权限体系:从"谁都能看"到"该看什么看什么"
前端·后端·架构