当前位置：首页 > article >正文

过滤器（Filter）与拦截器（Interceptor）

article 2025/3/14 10:27:26

在Java Web开发中，**拦截器（Interceptor）和过滤器（Filter）**都用于在请求处理过程中拦截和处理HTTP请求或响应，但它们有不同的应用场景和工作原理。下面将详细解释它们的区别，并提供代码演示。

1. 过滤器（Filter）

过滤器是基于Java EE的Servlet规范提供的一个功能，用来在请求到达Servlet之前或者在响应返回给客户端之前对请求和响应进行预处理或后处理。过滤器可以对请求和响应做一些全局处理，通常用于日志记录、性能监控、安全控制、请求重定向等。

过滤器的特点：

过滤器是基于Servlet的API实现的。
过滤器是处理请求/响应的预处理器和后处理器。
过滤器不直接访问业务逻辑，它只是对HTTP请求和响应做处理。
过滤器通常用于请求的前置处理（如验证身份）或响应的后置处理（如日志记录）。

2. 拦截器（Interceptor）

拦截器通常是应用框架（如Spring MVC）提供的功能，用于在业务方法执行之前和之后进行拦截。拦截器的设计更灵活，能够对控制器方法进行前置处理和后置处理。拦截器通常是框架级别的扩展，主要用于业务逻辑的增强。

拦截器的特点：

拦截器通常是框架提供的（例如Spring MVC中的HandlerInterceptor）。
拦截器能够访问应用程序的业务逻辑，通常在控制器方法执行前后执行。
拦截器更适合用于控制器级别的功能增强，例如权限控制、日志记录等。

主要区别：

功能的区别：
- 过滤器主要用于处理请求和响应的预处理和后处理，通常处理的是HttpServletRequest和HttpServletResponse。
- 拦截器用于对业务逻辑进行前置和后置增强，通常与控制器相关，可以在执行Controller方法之前和之后进行处理。
生命周期：
- 过滤器是Servlet容器的一部分，它是在Servlet容器的生命周期内执行的。
- 拦截器是框架的一个扩展（如Spring MVC），它是应用程序的逻辑一部分。
作用范围：
- 过滤器的作用范围较广，通常用于全局处理请求和响应。
- 拦截器更关注具体的控制器或业务方法。

代码示例

1. 过滤器代码示例

首先，我们创建一个简单的过滤器，在请求到达Servlet之前进行一些操作。

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

@WebFilter("/hello")  // 设置过滤器的URL模式，可以过滤所有请求（/*）或特定路径
public class MyFilter implements Filter {

    @Override
    public void init(FilterConfig filterConfig) throws ServletException {
        // 过滤器初始化时调用
        System.out.println("Filter initialized");
    }

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        // 过滤器处理逻辑，访问控制、日志记录等
        System.out.println("Filter is processing the request before passing to the servlet");

        // 将请求传递给下一个过滤器或目标Servlet
        chain.doFilter(request, response);

        // 过滤器的后处理逻辑，在响应返回客户端之前执行
        System.out.println("Filter is processing the response after servlet execution");
    }

    @Override
    public void destroy() {
        // 过滤器销毁时调用
        System.out.println("Filter destroyed");
    }
}

解释：

@WebFilter("/hello")：指定了该过滤器拦截的URL路径，在这里拦截 /hello 路径的请求。
init()：在过滤器初始化时调用。
doFilter()：实际的过滤处理，执行完后通过chain.doFilter()将请求传递给下一个过滤器或Servlet。你可以在此前后加入自己的处理逻辑。
destroy()：过滤器销毁时调用。

2. 拦截器代码示例（Spring MVC）

在Spring MVC中，拦截器通常通过实现HandlerInterceptor接口来创建。下面是一个简单的拦截器示例。

拦截器实现：

import org.springframework.web.servlet.HandlerInterceptor;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class MyInterceptor implements HandlerInterceptor {

    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        // 在Controller方法执行之前执行
        System.out.println("Interceptor: Before executing the controller method");

        // 如果返回false，表示请求不继续处理
        // 返回true，表示请求继续传递到目标控制器
        return true;
    }

    @Override
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
        // 在Controller方法执行后，视图渲染前执行
        System.out.println("Interceptor: After executing the controller method but before view rendering");
    }

    @Override
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
        // 在整个请求处理完成后执行，响应已经被返回
        System.out.println("Interceptor: After request completion (view rendered)");
    }
}

配置拦截器：

在Spring配置文件（如applicationContext.xml）中配置拦截器：

<bean class="org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter">
    <property name="interceptors">
        <list>
            <bean class="com.example.MyInterceptor" />
        </list>
    </property>
</bean>

或者在Java配置中进行拦截器的注册：

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 MyInterceptor()).addPathPatterns("/hello");
    }
}