Filter拦截器的使用

前言 

filter（过滤器）和interceptor（拦截器）虽然都用于在请求处理过程中插入自定义逻辑，但它们通常在不同的上下文和框架中有所区别。然而，在许多Web框架（如Spring MVC、Spring Boot、Java EE等）和JavaScript框架（如AngularJS、Angular等）中，拦截器（Interceptor）的概念更为常见，用于在请求被处理之前或之后执行代码。而在一些其他框架（如Servlet）中，则使用过滤器（Filter）来实现类似的功能。

这里我将分别介绍在Java Web（使用Servlet Filter）和Spring MVC（使用Interceptor）中如何使用这些技术。

Servlet Filter

在Java Servlet中，Filter是一种可以复用于多个Servlet的Java组件，它能够对发送到Servlet的请求和从Servlet发送的响应进行拦截处理

创建Filter

1. 实现javax.servlet.Filter接口。
2. 在实现的类中重写doFilter方法，添加你的处理逻辑。

import javax.servlet.*;  
import java.io.IOException;  
  
public class MyFilter implements Filter {  
    @Override  
    public void init(FilterConfig filterConfig) throws ServletException {  
        // 初始化代码  
    }  
  
    @Override  
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)  
            throws IOException, ServletException {  
        // 在请求处理之前执行的代码  
  
        // 继续调用链中的下一个Filter或Servlet  
        chain.doFilter(request, response);  
  
        // 在请求处理之后执行的代码  
    }  
  
    @Override  
    public void destroy() {  
        // 清理代码  
    }  
}

 

配置Filter 

在web.xml中配置Filter：

<filter>  
    <filter-name>myFilter</filter-name>  
    <filter-class>com.example.MyFilter</filter-class>  
</filter>  
<filter-mapping>  
    <filter-name>myFilter</filter-name>  
    <url-pattern>/*</url-pattern> <!-- 匹配所有请求 -->  
</filter-mapping>

或者使用Servlet 3.0+的注解方式（如果Servlet容器支持）：

@WebFilter("/*")  
public class MyFilter implements Filter {  
    // ...  
}

Spring MVC Interceptor

在Spring MVC中，Interceptor提供了一种机制来拦截控制器方法调用之前或之后的执行。

创建Interceptor

实现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方法调用之前）  
        return true; // 只有返回true才会继续流程（如调用下一个interceptor或处理器）  
    }  
  
    @Override  
    public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {  
        // 请求处理之后进行调用，但是在视图被渲染之前（Controller方法调用之后）  
    }  
  
    @Override  
    public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {  
        // 在整个请求结束之后被调用，也就是在DispatcherServlet渲染了视图执行  
    }  
}

配置Interceptor

在Spring MVC配置中注册Interceptor。

import org.springframework.beans.factory.annotation.Autowired;  
import org.springframework.context.annotation.Configuration;  
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;  
import org.springframework.web.servlet.config.annotation.WebMvcConfigurer;  
  
@Configuration  
public class WebConfig implements WebMvcConfigurer {  
  
    @Autowired  
    private MyInterceptor myInterceptor;  
  
    @Override  
    public void addInterceptors(InterceptorRegistry registry) {  
        registry.addInterceptor(myInterceptor)  
                .addPathPatterns("/**") // 拦截所有请求  
                .excludePathPatterns("/exclude/**"); // 排除特定路径  
    }  
}

总结

在Spring Boot应用中，通常不需要显式地实现WebMvcConfigurer接口，而是可以使用配置类加上@EnableWebMvc注解（但通常不推荐，因为它会覆盖Spring Boot的自动配置），或者更常见的是通过Java配置来注册Interceptor。在Spring Boot中，可以通过实现WebMvcConfigurer接口并覆盖addInterceptors方法来注册Interceptor，