Spring常用过滤器（Filter）-ExceptionTranslationFilter

ExceptionTranslationFilter：异常转换过滤器，用于将安全相关的异常转换为Spring Security的AuthenticationException

1.1 功能概述：
1.1.1 ExceptionTranslationFilter的主要功能是将Spring Security过滤器链中出现的特定异常（如认证异常和访问拒绝异常）转换为合适的HTTP响应或重定向操作。它并不直接处理异常，而是将异常转发给相应的处理器进行处理。
1.2 工作原理：
1.2.1 当请求经过Spring Security过滤器链时，如果某个过滤器抛出了异常（如AuthenticationException或AccessDeniedException），则ExceptionTranslationFilter会捕获这些异常，并根据异常的类型进行不同的处理。
1.2.2 认证异常（AuthenticationException）：如果捕获到的是AuthenticationException异常，表示用户认证失败。此时，ExceptionTranslationFilter会调用内部的AuthenticationEntryPoint进行重定向操作，将用户重定向到登录页面或其他认证入口。
1.2.3 访问拒绝异常（AccessDeniedException）：如果捕获到的是AccessDeniedException异常，表示用户没有权限访问请求的资源。此时，ExceptionTranslationFilter会首先判断当前用户是否是匿名用户。如果是匿名用户，则同样调用AuthenticationEntryPoint进行重定向操作。如果不是匿名用户，则会调用AccessDeniedHandler进行处理，通常是将用户重定向到错误页面或显示错误消息。
1.3 核心代码分析：
1.3.1 doFilterInternal 是 ExceptionTranslationFilter 的主要方法，它负责处理传入的 HTTP 请求和响应，并在必要时捕获和处理异常。

@Override  
protected void doFilterInternal(HttpServletRequest request,  
                                HttpServletResponse response,  
                                FilterChain filterChain)  
                                throws ServletException, IOException {  
    try {  
        filterChain.doFilter(request, response); // 继续过滤器链  
    } catch (Throwable ex) {  
        // 捕获过滤器链中抛出的异常  
        Throwable cause = ex.getCause();  
          
        if (cause instanceof AuthenticationException) {  
            // 处理认证异常  
            handleSpringSecurityException((AuthenticationException) cause, request, response);  
        } else if (cause instanceof AccessDeniedException) {  
            // 处理访问拒绝异常  
            Authentication authentication = SecurityContextHolder.getContext().getAuthentication();  
            if (authenticationTrustResolver.isAnonymous(authentication) || authenticationTrustResolver.isRememberMe(authentication)) {  
                // 如果用户是匿名或使用了“记住我”功能，则重定向到认证入口  
                handleSpringSecurityException((AccessDeniedException) cause, request, response);  
            } else {  
                // 否则，调用AccessDeniedHandler处理  
                accessDeniedHandler.handle(request, response, (AccessDeniedException) cause);  
            }  
        } else {  
            // 处理其他类型的异常  
            throw ex;  
        }  
    }  
}

1.4 核心组件：
1.4.1 AuthenticationEntryPoint：认证入口点，用于处理认证失败的场景。它通常会将用户重定向到登录页面或其他认证入口，并显示相应的认证失败信息。
1.4.2 AccessDeniedHandler：访问拒绝处理器，用于处理用户没有权限访问资源的场景。它可以根据配置将用户重定向到错误页面、显示错误消息或执行其他操作。
1.4.3 AuthenticationTrustResolver：用于判断SecurityContextHolder中存储的Authentication对象是否表示匿名用户或记住我用户。这有助于ExceptionTranslationFilter在处理AccessDeniedException时做出正确的决策。
1.4.4 RequestCache：请求缓存，用于缓存用户请求的信息。当认证完成后，可以从缓存中获取原始请求，并继续执行引发认证的原始请求。
1.5 配置与自定义：
可以通过配置Spring Security来自定义ExceptionTranslationFilter的行为。例如，可以自定义AuthenticationEntryPoint和AccessDeniedHandler的实现，以提供自定义的认证失败和访问拒绝处理逻辑。此外，还可以通过配置RequestCache来缓存用户请求的信息，以便在认证完成后能够继续执行原始请求。
1.6 与其他过滤器的关系：
ExceptionTranslationFilter通常位于Spring Security过滤器链的后方，负责捕获和处理过滤器链中出现的异常。它与其他过滤器（如UsernamePasswordAuthenticationFilter、BasicAuthenticationFilter等）协同工作，共同实现Spring Security的认证和授权功能。