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

クラス SimpleUrlAuthenticationFailureHandler

  • 実装されたすべてのインターフェース:
    AuthenticationFailureHandler
    既知の直属サブクラス
    ExceptionMappingAuthenticationFailureHandler
    public class SimpleUrlAuthenticationFailureHandler
extends java.lang.Object
implements AuthenticationFailureHandler
    AuthenticationFailureHandler は、onAuthenticationFailure メソッドが呼び出されたときに、defaultFailureUrl プロパティの値へのリダイレクトを実行します。プロパティが設定されていない場合は、失敗の原因となった AuthenticationException からのエラーメッセージとともに、401 レスポンスがクライアントに送信されます。

    useForward プロパティが設定されている場合、リダイレクトではなく、宛先に対して RequestDispatcher.forward 呼び出しが行われます。

    導入:
    3.0

    • フィールドの詳細

      • logger

        protected final org.apache.commons.logging.Log logger

    • コンストラクターの詳細

      • SimpleUrlAuthenticationFailureHandler

        public SimpleUrlAuthenticationFailureHandler()

      • SimpleUrlAuthenticationFailureHandler

        public SimpleUrlAuthenticationFailureHandler​(java.lang.String defaultFailureUrl)

    • メソッドの詳細

      • onAuthenticationFailure

        public void onAuthenticationFailure​(javax.servlet.http.HttpServletRequest request,
                                    javax.servlet.http.HttpServletResponse response,
                                    AuthenticationException exception)
                             throws java.io.IOException,
                                    javax.servlet.ServletException
        設定されている場合、defaultFailureUrl へのリダイレクトまたは転送を実行します。それ以外の場合は、401 エラーコードを返します。

        リダイレクトまたは転送する場合、saveException が呼び出され、例外をキャッシュしてターゲットビューで使用します。

        次で指定:
        インターフェース AuthenticationFailureHandler の onAuthenticationFailure 
        パラメーター:
        request - 認証試行が発生したリクエスト。
        response - レスポンス。
        exception - 認証リクエストを拒否するためにスローされた例外。
        例外:
        java.io.IOException
        javax.servlet.ServletException

      • saveException

        protected final void saveException​(javax.servlet.http.HttpServletRequest request,
                                   AuthenticationException exception)
        ビューのレンダリングで使用するために AuthenticationException をキャッシュします。

        forwardToDestination が true に設定されている場合、リクエストスコープが使用されます。それ以外の場合は、セッションに例外を格納しようとします。セッションがなく、allowSessionCreation が true の場合、セッションが作成されます。そうでない場合、例外は保存されません。

      • setDefaultFailureUrl

        public void setDefaultFailureUrl​(java.lang.String defaultFailureUrl)
        失敗の宛先として使用される URL。
        パラメーター:
        defaultFailureUrl - 障害 URL、たとえば "/loginFailed.jsp"。

      • isUseForward

        protected boolean isUseForward()

      • setUseForward

        public void setUseForward​(boolean forwardToDestination)
        true に設定されている場合、リダイレクトではなく、失敗した宛先 URL への転送を実行します。デフォルトは false です。

      • setRedirectStrategy

        public void setRedirectStrategy​(RedirectStrategy redirectStrategy)
        ターゲット URL にリダイレクトするときの動作をオーバーライドできます。

      • isAllowSessionCreation

        protected boolean isAllowSessionCreation()

      • setAllowSessionCreation

        public void setAllowSessionCreation​(boolean allowSessionCreation)