springboot filterchain

### Spring Boot 中 `FilterChain` 的使用方法

在Spring Boot应用程序中，`FilterChain` 是用于执行一系列过滤器链的关键组件。当一个请求进入应用时，它会依次经过这些过滤器，在每个过滤器完成其特定的任务之后再传递给下一个过滤器或最终的目标资源。

#### 创建并注册自定义过滤器

为了利用 `FilterChain` 来增强Web应用程序的功能，比如处理跨域资源共享(CORS)，可以创建一个新的类继承自 `OncePerRequestFilter` 或者直接实现 `javax.servlet.Filter` 接口，并重写其中的 `doFilterInternal` 方法[^3]：

import org.springframework.stereotype.Component;
import javax.servlet.*;
import java.io.IOException;

@Component
public class CustomFilter implements Filter {

    @Override
    public void doFilter(ServletRequest request, ServletResponse response, FilterChain chain)
            throws IOException, ServletException {
        try {
            // 在这里添加前置逻辑
            
            System.out.println("Before processing the request");

            // 将控制权交给下一个过滤器/目标资源
            chain.doFilter(request, response);

            // 在这里添加后置逻辑
            System.out.println("After processing the request");
            
        } catch (Exception e) {
            throw new RuntimeException(e);
        }
    }

}

在这个例子中，`chain.doFilter()` 调用使得当前过滤器能够把请求继续向下传递到下一层过滤器或是控制器层去处理实际业务逻辑；而在此调用前后都可以放置一些额外的操作来进行预处理和后处理工作。

#### 注册过滤器至过滤器链

为了让自定义过滤器生效，还需要将其加入到Spring Boot的应用上下文中以便自动装配成为过滤器链条的一部分。这可以通过声明该类为Spring Bean来轻松做到，如上面代码所示已经加上了 `@Component` 注解使其成为一个Bean实例[^1]。

另外一种更细粒度的方式是通过配置类显式地向容器内注册过滤器对象以及指定它们之间的顺序关系:

@Configuration
public class WebConfig implements WebMvcConfigurer {

    private final CustomFilter customFilter;

    @Autowired
    public WebConfig(CustomFilter customFilter){
        this.customFilter = customFilter;
    }

    @Override
    public void addFilters(FilterRegistry registry) {
        registry.addFilter(customFilter).order(1);  // 设置此过滤器优先级为1
    }
    
}

这样就完成了对 `CustomFilter` 进行初始化并将之纳入到了整个web应用的过滤器体系之中，每当有新的HTTP请求到来都会按照设定好的次序逐一触发各个已知类型的过滤操作直至结束为止。