パッケージ jakarta.security.enterprise.authentication.mechanism.http

アノテーションインターフェース LoginToContinue

@InheritedSE @InterceptorBinding @RetentionSE(RUNTIMESE) @TargetSE(TYPESE) public @interface LoginToContinue
LoginToContinue アノテーションは、認証メカニズムに機能を継続するためにアプリケーションにログインを宣言的に追加する機能を提供します。

LoginToContinue アノテーションがカスタム認証メカニズムで使用される場合、String 型の属性の式言語式は、認証を必要とするすべてのリクエストに対して評価されます。即時構文と遅延構文の両方がサポートされていますが、事実上、セマンティクスは常に遅延されます。

LoginToContinue アノテーションが FormAuthenticationMechanismDefinition または CustomFormAuthenticationMechanismDefinition のいずれかの属性として使用されている場合、即時構文を使用する式は、HttpAuthenticationMechanism Bean の作成時に一度だけ評価されます。これらの Bean はアプリケーションスコープなので、アプリケーションごとに 1 回だけです。遅延構文を使用する式は、LoginToContinue アノテーションがカスタム認証メカニズムで使用される場合、上記のように評価されます。

  • ネストされたクラスの要約

    ネストされたクラス
    修飾子と型
    クラス
    説明
    static final class
    LoginToContinue.Literal
    LoginToContinue アノテーションのインラインインスタンス化をサポートします。

  • オプション要素の概要

    オプション要素
    修飾子と型
    オプションの要素
    説明
    StringSE
    errorPage
    loginPage() によって設定されたページで無効な資格情報の提供などのエラーが発生した場合に、呼び出し元が確認する必要があるリソース（ページ）。
    StringSE
    loginPage
    最初にリクエストされたリソースが認証を必要とし、呼び出し元が現在認証されていない場合に、呼び出し元が見る必要があるリソース（ページ）。
    boolean
    useForwardToLogin
    true の場合、転送を使用して loginPage() によって設定されたページに到達します。それ以外の場合は、リダイレクトを使用します。
    StringSE
    useForwardToLoginExpression
    useForwardToLogin() の Jakarta Expression Language 式バリアント。

  • 要素の詳細

    • loginPage

      StringSE loginPage
      最初にリクエストされたリソースが認証を必要とし、呼び出し元が現在認証されていない場合に、呼び出し元が見る必要があるリソース（ページ）。
      戻り値:
      呼び出し元が認証するように指示されたページ (ログイン)
      デフォルト:
      "/login"

    • useForwardToLogin

      boolean useForwardToLogin
      true の場合、転送を使用して loginPage() によって設定されたページに到達します。それ以外の場合は、リダイレクトを使用します。
      戻り値:
      転送が使用される場合は true、リダイレクトの場合は false
      デフォルト:
      true

    • useForwardToLoginExpression

      StringSE useForwardToLoginExpression
      useForwardToLogin() の Jakarta Expression Language 式バリアント。式はブール結果に評価される必要があります。名前付き CDI Bean はすべて式で使用できます。この属性と useForwardToLogin() の両方が指定されている場合、この属性が優先されます。
      戻り値:
      転送が使用される場合は true、リダイレクトの場合は false と評価される式
      デフォルト:
      ""

    • errorPage

      StringSE errorPage
      loginPage() によって設定されたページで無効な資格情報の提供などのエラーが発生した場合に、呼び出し元が確認する必要があるリソース（ページ）。
      戻り値:
      認証（ログイン）エラーの後に呼び出し元が誘導されるページ
      デフォルト:
      "/login-error"