springboot添加OncePerRequestFilter，并配置config

### 如何在 Spring Boot 中添加 OncePerRequestFilter 并进行配置

为了在 Spring Boot 应用程序中利用 `OncePerRequestFilter` 来拦截和处理 HTTP 请求，需遵循特定的步骤。创建一个新的 Java 类，该类应扩展 `OncePerRequestFilter` 抽象类，并重写其 `doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain)` 方法，在此方法内编写具体的业务逻辑[^1]。

下面是一个简单的例子展示如何实现这一点：

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

public class CustomFilter extends OncePerRequestFilter {

    @Override
    protected void doFilterInternal(HttpServletRequest httpServletRequest,
                                    HttpServletResponse httpServletResponse,
                                    FilterChain filterChain) throws ServletException, IOException {
        // 自定义逻辑在此处添加
        
        System.out.println("Before processing the request");
        
        // 继续调用下一个过滤器或目标资源
        filterChain.doFilter(httpServletRequest, httpServletResponse);
        
        System.out.println("After processing the request");
    }
}

为了让上述自定义过滤器生效，还需将其注册至 Spring 容器之中。可以通过两种方式完成这一操作：一种是在主应用类上通过注解形式声明；另一种则是构建专门的配置类来进行更复杂的设置。这里采用第二种方案作为示范。

#### 创建配置类以注册过滤器

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class WebConfig {

    @Bean
    public CustomFilter customFilter() {
        return new CustomFilter();
    }

    /*
     * 如果需要调整过滤器顺序或其他高级选项，
     * 可以返回 FilterRegistrationBean 对象而不是直接返回过滤器实例。
     */
//    @Bean
//    public FilterRegistrationBean<CustomFilter> loggingFilter(){
//        FilterRegistrationBean<CustomFilter> registrationBean =
//                new FilterRegistrationBean<>();
//
//        registrationBean.setFilter(new CustomFilter());
//        registrationBean.addUrlPatterns("/api/*");  // 设置匹配路径
//        registrationBean.setOrder(1);               // 设定优先级
//
//        return registrationBean;
//    }
}

这样就完成了 `OncePerRequestFilter` 的集成工作。每当有符合条件的请求到达服务器时，都会先经过所定义的过滤器再继续后续流程。