Module jdk.httpserver

Package com.sun.net.httpserver

Class Authenticator

java.lang.Object

com.sun.net.httpserver.Authenticator

直接已知的子类:

BasicAuthenticator

       public abstract class Authenticator extends Object
      

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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	Authenticator.Failure	表示身份验证失败。
static class	Authenticator.Result	authenticate(HttpExchange)方法的返回类型的基类。
static class	Authenticator.Retry	表示必须重试身份验证。
static class	Authenticator.Success	表示身份验证已成功，并且经过身份验证的用户principal可以通过调用Authenticator.Success.getPrincipal()来获取。

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	Authenticator()	子类调用的构造函数。

Method Summary

Modifier and Type	Method	Description
abstract Authenticator.Result	authenticate(HttpExchange exch)	用于对每个传入请求进行身份验证。

Methods declared in class java.lang.Object

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

Constructor Details

Authenticator

             protected Authenticator()
            

子类调用的构造函数。

Method Details

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

返回:

结果