モジュール jdk.httpserver

パッケージ com.sun.net.httpserver

クラスAuthenticator

java.lang.Object

com.sun.net.httpserver.Authenticator

直系の既知のサブクラス:

BasicAuthenticator

public abstract class Authenticator extends Object

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

導入されたバージョン:

1.6

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

ネストされたクラス

修飾子と型	クラス	説明
static class	Authenticator.Failure	認証の失敗を示します。
static class	Authenticator.Result	authenticate(HttpExchange)メソッドからの戻り型のベース・クラス。
static class	Authenticator.Retry	認証を再試行する必要があることを示します。
static class	Authenticator.Success	認証が成功し、Authenticator.Success.getPrincipal()をコールして認証済ユーザーprincipalを取得できることを示します。

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

コンストラクタ

修飾子	コンストラクタ	説明
protected	Authenticator()	サブクラスが呼び出すためのコンストラクタ。

メソッドのサマリー

修飾子と型	メソッド	説明
abstract Authenticator.Result	authenticate(HttpExchange exch)	各着信リクエストを認証するために呼び出されます。

クラスjava.lang.Objectで宣言されたメソッド

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

コンストラクタの詳細

Authenticator

protected Authenticator()

サブクラスが呼び出すためのコンストラクタ。

メソッドの詳細

authenticate

public abstract Authenticator.Result authenticate(HttpExchange exch)

各着信リクエストを認証するために呼び出されます。 実装は、必要に応じてAuthenticator.Failure、Authenticator.SuccessまたはAuthenticator.Retryオブジェクトを返す必要があります:

• Failureは、認証は完了したが、資格証明が無効なために失敗したことを意味します。
• Successは、認証が成功し、Authenticator.Success.getPrincipal()をコールしてユーザーを表すPrincipalオブジェクトを取得できることを意味します。
• Retryは、別のHTTP exchangeが必要であることを意味します。 クライアントに返送する必要があるレスポンス・ヘッダーは、指定されたHttpExchangeで設定されます。 返されるレスポンス・コードは、Retryオブジェクトで指定する必要があります。 Retryが複数回発生する場合があります。

パラメータ:

exch - 認証が呼び出されるHttpExchange

戻り値:

結果