package com.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.servlet.config.annotation.InterceptorRegistry;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurationSupport;

import com.interceptor.AuthorizationInterceptor;

/**
 * Spring MVC 全局拦截器与静态资源配置类
 *
 * <p>核心职责：
 * <ul>
 *   <li>注册并配置自定义拦截器（如认证拦截器）</li>
 *   <li>解决静态资源访问问题（覆盖默认配置时需手动指定）</li>
 *   <li>定制化Web MVC行为</li>
 * </ul>
 *
 * <p><b>注意事项：</b>
 * 继承 {@link WebMvcConfigurationSupport} 会覆盖Spring Boot的自动配置，
 * 需要手动处理静态资源映射，否则会导致静态资源无法访问。
 *
 * @author YourName
 * @version 1.0
 * @since 2023-10-01
 */
@Configuration  // 声明此类为Spring配置类
public class InterceptorConfig extends WebMvcConfigurationSupport {

    /**
     * 创建授权拦截器Bean
     *
     * <p>使用 {@code @Bean} 注解将拦截器实例纳入Spring容器管理，
     * 确保拦截器中的依赖注入能正常工作。
     *
     * @return 初始化完成的授权拦截器实例
     */
    @Bean
    public AuthorizationInterceptor getAuthorizationInterceptor() {
        return new AuthorizationInterceptor();
    }

    /**
     * 注册拦截器并配置拦截规则
     *
     * <p><b>拦截配置说明：</b>
     * <ul>
     *   <li>{@code .addPathPatterns("/**")} - 拦截所有请求路径</li>
     *   <li>{@code .excludePathPatterns("/static/**")} - 排除静态资源路径</li>
     * </ul>
     *
     * <p>典型应用场景：
     * <ul>
     *   <li>检查API请求的Token有效性</li>
     *   <li>记录请求日志</li>
     *   <li>权限验证</li>
     * </ul>
     *
     * @param registry 拦截器注册器
     */
    @Override
    public void addInterceptors(InterceptorRegistry registry) {
        // 核心拦截器配置
        registry.addInterceptor(getAuthorizationInterceptor())
                .addPathPatterns("/**")           // 拦截所有路径
                .excludePathPatterns("/static/**"); // 排除静态资源

        // 保留父类注册逻辑（可选）
        super.addInterceptors(registry);
    }

    /**
     * 配置静态资源处理规则
     *
     * <p><b>必要性：</b>当覆盖 {@code WebMvcConfigurationSupport} 时，
     * Spring Boot的默认静态资源配置会失效，必须手动指定资源映射。
     *
     * <p><b>资源位置说明：</b>
     * <table border="1">
     *   <tr><th>路径模式</th><th>物理位置</th><th>典型内容</th></tr>
     *   <tr><td>/**</td><td>classpath:/resources/</td><td>XML配置文件</td></tr>
     *   <tr><td>/**</td><td>classpath:/static/</td><td>CSS/JS/图片</td></tr>
     *   <tr><td>/**</td><td>classpath:/admin/</td><td>后台管理界面资源</td></tr>
     *   <tr><td>/**</td><td>classpath:/front/</td><td>前端界面资源</td></tr>
     *   <tr><td>/**</td><td>classpath:/public/</td><td>公共资源</td></tr>
     * </table>
     *
     * <p><b>特殊说明：</b>
     * 在Spring Boot中，通常不需要此配置，除非需要完全自定义MVC行为。
     *
     * @param registry 资源处理器注册器
     */
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 配置静态资源映射
        registry.addResourceHandler("/**")  // 匹配所有URL路径
                .addResourceLocations("classpath:/resources/")  // 资源位置1
                .addResourceLocations("classpath:/static/")     // 资源位置2
                .addResourceLocations("classpath:/admin/")     // 资源位置3
                .addResourceLocations("classpath:/front/")      // 资源位置4
                .addResourceLocations("classpath:/public/");    // 资源位置5

        // 保留父类配置（可选）
        super.addResourceHandlers(registry);
    }
}