モジュール jdk.httpserver
パッケージ com.sun.net.httpserver

クラスAuthenticator

  • 直系の既知のサブクラス:
    BasicAuthenticator
    public abstract class Authenticator
extends Object
    Authenticatorは、HTTP認証メカニズムの実装を表します。 サブクラスは、ダイジェスト認証や基本認証などの特定のメカニズムの実装を提供します。 インスタンスは、すべての着信要求に提供される認証情報の検証を提供するために呼び出されます。 注: これは、資格またはその他の認証情報のキャッシュをこのクラスの外部で行う必要があることを意味します。

    • ネストされたクラスのサマリー

      ネストされたクラス 
      修飾子と型 クラス 説明
      static class  Authenticator.Failure
      認証の失敗を示します。
      static class  Authenticator.Result
      authenticate()メソッドからの戻り値の型の基底クラスです。
      static class  Authenticator.Retry
      認証を再試行する必要があることを示します。
      static class  Authenticator.Success
      認証が成功し、getPrincipal()を呼び出すことによって認証されたユーザー主体を取得できることを示します。

    • コンストラクタのサマリー

      コンストラクタ 
      コンストラクタ 説明
      Authenticator()  

    • コンストラクタの詳細

      • Authenticator

        public Authenticator()

    • メソッドの詳細

      • authenticate

        public abstract Authenticator.Result authenticate​(HttpExchange exch)
        各着信要求を認証するために呼び出されます。 実装は、必要に応じてFailure、Success、またはRetryオブジェクトを返す必要があります。

        Failureは、認証は完了したが、無効な資格のために失敗したことを意味します。

        Sucessは、認証が正常に行われ、Sucess.getPrincipal()を呼び出すことでユーザーを表すPrincipalオブジェクトを取得できることを意味します。

        Retryは、別のHTTP交換が必要であることを意味します。 クライアントに送り返す必要がある応答ヘッダーは、指定されたHttpExchangeに設定されます。 返される応答コードをRetryオブジェクトに提供する必要があります。 Retryは複数回発生することがあります。