java OncePerRequestFilter

`OncePerRequestFilter` 是 Java 的一个过滤器设计模式，主要用于Spring框架中，确保在一个HTTP请求周期内，某个特定的过滤操作只会执行一次。这个过滤器通常用于需要在整个请求生命周期中执行但不需要重复执行的逻辑，比如身份验证。

在Spring Security中，如果你希望防止如身份验证之类的操作在每次请求时都被执行，可以使用 `OncePerRequestFilter` 作为基础并重写其关键方法来实现自定义行为。

具体步骤如下：

1. **继承** `OncePerRequestFilter` 类：

   public class CustomFilter extends OncePerRequestFilter {
       // ...
   }

2. **覆盖** `shouldNotFilter` 方法：
这个方法允许你在每次请求之前决定是否需要继续执行当前过滤器。如果返回 `true`，则跳过过滤；否则执行默认的行为。例如，在上述示例中[^1]，我们检查请求的 URI 是否包含 `/healthcheck.html`，如果是，则返回 `true`，避免执行过滤器。

@Override
protected boolean shouldNotFilter(HttpServletRequest request) throws ServletException {
    // 自定义过滤逻辑
    if (/* 根据需求判断 */) {
        return true;
    }
    // 如果未满足条件，则执行默认过滤逻辑
    return super.shouldNotFilter(request);
}

这样，`CustomFilter` 只会在第一次请求时执行你的自定义过滤逻辑，后续同一次请求不会再被执行。