模块 jdk.httpserver

包 com.sun.net.httpserver

类 Authenticator

java.lang.Object

com.sun.net.httpserver.Authenticator

已知子类：

BasicAuthenticator

public abstract class Authenticator extends Object 
      

Authenticator 表示 HTTP 身份验证机制的实现。子类提供特定机制的实现，例如 Digest 或 Basic auth。调用实例来验证所有传入请求中提供的身份验证信息。笔记。这意味着任何凭证或其他身份验证信息的缓存都必须在此类之外完成。

内部类总结

内部类

修饰符和类型	类	描述
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 - 调用 authenticate 的 HttpExchange

返回：

结果