Spring Framework的OncePerRequestFilter 的作用

org.springframework.web.filter.OncePerRequestFilter 是 Spring Framework 中提供的一个过滤器类，它继承自 Servlet API 中的 javax.servlet.Filter 接口，同时实现了 Spring 提供的 org.springframework.web.filter.GenericFilterBean 类。这个类的作用主要是确保一个请求只被过滤一次，而不会多次执行过滤操作。

具体来说，OncePerRequestFilter 的作用包括：

1. 确保过滤器的 doFilter 方法只在每个请求中执行一次：

   • 通过 OncePerRequestFilter，Spring 确保对每个请求只调用一次 doFilter 方法，避免多次执行过滤器操作，保证过滤器的逻辑只会在请求处理过程中执行一次。

2. 处理请求前、处理后的逻辑：

   • 您可以重写 doFilterInternal 方法，在其中编写处理请求前和处理请求后的逻辑，例如记录请求信息、处理请求参数等。

3. 与 Spring Web 应用程序的集成：

   • OncePerRequestFilter 是一个适用于 Spring Web 应用程序的过滤器类，可以方便地集成到 Spring Web 应用程序的过滤器链中，用于处理请求前、请求后的逻辑。

下面是一个简单示例，展示如何创建自定义的 OncePerRequestFilter 子类：

import javax.servlet.FilterChain;
import javax.servlet.ServletException;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import org.springframework.web.filter.OncePerRequestFilter;

public class CustomFilter extends OncePerRequestFilter {

    @Override
    protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)
            throws ServletException, IOException {
        // 处理请求前的逻辑
        System.out.println("Before filtering request");

        // 让请求继续传递给下一个过滤器或目标资源
        filterChain.doFilter(request, response);

        // 处理请求后的逻辑
        System.out.println("After filtering request");
    }
}

在上面的示例中，我们创建了一个自定义的 OncePerRequestFilter 子类 CustomFilter，重写了 doFilterInternal 方法，在其中可以编写处理请求前和请求后逻辑的代码。

使用 OncePerRequestFilter 的好处是确保过滤器逻辑只会在每个请求中执行一次，避免重复执行过滤器操作。

1. 使用 Ordered 接口或 @Order 注解：
   • 让过滤器类实现 Ordered 接口或使用 @Order 注解来指定过滤器的执行顺序。

@Component
@Order(1)
public class CustomFilter1 extends OncePerRequestFilter {
    // Filter logic
}

@Component
@Order(2)
public class CustomFilter2 extends OncePerRequestFilter {
    // Filter logic
}