パッケージ org.springframework.security.web.access

クラス ExceptionTranslationFilter

  • 実装されたすべてのインターフェース:
    javax.servlet.Filter、org.springframework.beans.factory.Aware、org.springframework.beans.factory.BeanNameAware、org.springframework.beans.factory.DisposableBean、org.springframework.beans.factory.InitializingBean、org.springframework.context.EnvironmentAware、org.springframework.context.MessageSourceAware、org.springframework.core.env.EnvironmentCapable、org.springframework.web.context.ServletContextAware
    public class ExceptionTranslationFilter
extends org.springframework.web.filter.GenericFilterBean
implements org.springframework.context.MessageSourceAware
    フィルターチェーン内でスローされた AccessDeniedException および AuthenticationException を処理します。

    このフィルターは、Java 例外と HTTP レスポンス間のブリッジを提供するために必要です。ユーザーインターフェースの維持にのみ関係します。このフィルターは、実際のセキュリティ実施を行いません。

    AuthenticationException が検出された場合、フィルターは authenticationEntryPoint を起動します。これにより、AbstractSecurityInterceptor の任意のサブクラスに起因する認証失敗の一般的な処理が可能になります。

    AccessDeniedException が検出された場合、フィルターはユーザーが匿名ユーザーであるかどうかを判別します。匿名ユーザーの場合、authenticationEntryPoint が起動します。それらが匿名ユーザーでない場合、フィルターは AccessDeniedHandler に委譲します。デフォルトでは、フィルターは AccessDeniedHandlerImpl を使用します。

    このフィルターを使用するには、次のプロパティを指定する必要があります。

    • authenticationEntryPoint は、AuthenticationException が検出された場合に認証プロセスを開始するハンドラーを示します。これにより、SSL ログインのために現在のプロトコルが http から https に切り替わることもあります。
    • requestCache は、ユーザーが認証されたらリクエストを取得して再利用できるように、認証プロセス中にリクエストを保存するために使用される戦略を決定します。デフォルトの実装は HttpSessionRequestCache です。

    • フィールドの詳細

      • messages

        protected org.springframework.context.support.MessageSourceAccessor messages

    • メソッドの詳細

      • afterPropertiesSet

        public void afterPropertiesSet()
        次で指定:
        インターフェース org.springframework.beans.factory.InitializingBean の afterPropertiesSet 
        オーバーライド:
        クラス org.springframework.web.filter.GenericFilterBean の afterPropertiesSet 

      • doFilter

        public void doFilter​(javax.servlet.ServletRequest request,
                     javax.servlet.ServletResponse response,
                     javax.servlet.FilterChain chain)
              throws java.io.IOException,
                     javax.servlet.ServletException
        次で指定:
        インターフェース javax.servlet.Filter の doFilter 
        例外:
        java.io.IOException
        javax.servlet.ServletException

      • sendStartAuthentication

        protected void sendStartAuthentication​(javax.servlet.http.HttpServletRequest request,
                                       javax.servlet.http.HttpServletResponse response,
                                       javax.servlet.FilterChain chain,
                                       AuthenticationException reason)
                                throws javax.servlet.ServletException,
                                       java.io.IOException
        例外:
        javax.servlet.ServletException
        java.io.IOException

      • setAccessDeniedHandler

        public void setAccessDeniedHandler​(AccessDeniedHandler accessDeniedHandler)

      • setAuthenticationTrustResolver

        public void setAuthenticationTrustResolver​(AuthenticationTrustResolver authenticationTrustResolver)

      • setThrowableAnalyzer

        public void setThrowableAnalyzer​(ThrowableAnalyzer throwableAnalyzer)

      • setMessageSource

        public void setMessageSource​(org.springframework.context.MessageSource messageSource)
        次で指定:
        インターフェース org.springframework.context.MessageSourceAware の setMessageSource 
        導入:
        5.5