CorsFilter 应用案例说明

CorsFilter 用于处理跨源资源共享（CORS）的过滤器。它允许配置CORS策略，使得服务器能够响应来自不同源的请求。

业务场景：

假设你正在开发一个提供RESTful API的Web服务，这个服务将被多个不同的客户端应用所使用，这些客户端应用可能位于不同的域上。根据浏览器的同源策略，当这些客户端尝试与你的API进行交互时，可能会遇到跨域请求的安全限制。为了解决这个问题，你需要启用CORS。

1. 配置CorsFilter：

import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.UrlBasedCorsConfigurationSource;
import org.springframework.web.filter.CorsFilter;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

import javax.servlet.Filter;

@Configuration
public class CorsConfig {

    @Bean
    public Filter corsFilter() {
        UrlBasedCorsConfigurationSource source = new UrlBasedCorsConfigurationSource();
        CorsConfiguration config = new CorsConfiguration();
        config.setAllowCredentials(true);
        config.addAllowedOrigin("*"); // 允许所有域名
        config.addAllowedHeader("*"); // 允许所有头
        config.addAllowedMethod("*"); // 允许所有方法
        source.registerCorsConfiguration("/**", config);
        return new CorsFilter(source);
    }
}

在这个配置中，我们创建了一个CorsFilter Bean，并设置了CORS配置，允许所有来源的请求。

2. 使用CorsFilter：

一旦CorsFilter被配置，它会拦截所有进入的HTTP请求，并根据配置的CORS策略来决定是否允许这些请求。

关键处理代码：

CorsFilter 的关键处理逻辑在于它如何处理HTTP请求和添加适当的响应头：

import org.springframework.web.cors.CorsConfiguration;
import org.springframework.web.cors.CorsProcessor;
import org.springframework.web.cors.CorsConfigurationSource;
import javax.servlet.*;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
import java.io.IOException;

public class CorsFilter extends GenericFilterBean {
    private final CorsConfigurationSource configurationSource;
    private CorsProcessor corsProcessor;

    public CorsFilter(CorsConfigurationSource configurationSource) {
        this.configurationSource = configurationSource;
    }

    @Override
    public void doFilter(ServletRequest req, ServletResponse res, FilterChain filterChain)
            throws IOException, ServletException {
        HttpServletRequest request = (HttpServletRequest) req;
        HttpServletResponse response = (HttpServletResponse) res;
        CorsConfiguration config = configurationSource.getCorsConfiguration(request);
        if (config != null) {
            corsProcessor = new CorsProcessor(config, request.getServerPort());
            corsProcessor.processRequest(request, response);
        }
        filterChain.doFilter(req, res);
    }
}

在这个示例中，CorsFilter 通过 CorsConfigurationSource 获取当前请求的CORS配置，并使用 CorsProcessor 来处理请求和添加必要的响应头，例如 Access-Control-Allow-Origin、Access-Control-Allow-Methods 等。

目的：

• CorsFilter 允许你的Web服务支持CORS，从而能够响应来自不同源的请求。
• 它为跨域请求提供了安全机制，允许你精细控制哪些源可以访问你的API。
• 使用CorsFilter可以提高Web服务的灵活性和可用性，使其能够被更多的客户端应用所使用。

通过使用CorsFilter，你可以确保Web服务的CORS策略得到正确实施，从而避免跨域请求带来的安全问题，并提供更好的开发体验。