Module  jdk.httpserver

Class BasicAuthenticator



  • public abstract class BasicAuthenticator
    extends Authenticator
    BasicAuthenticator提供HTTP Basic认证的实现。 它是一个抽象类,必须扩展以提供一个checkCredentials(String,String)的实现,该实现被调用来验证每个传入的请求。
    • 字段详细信息

      • realm

        protected String realm
    • 构造方法详细信息

      • BasicAuthenticator

        public BasicAuthenticator​(String realm)
        为给定的HTTP领域创建BasicAuthenticator
        参数
        realm - HTTP基本认证领域
        异常
        NullPointerException - 如果领域是空字符串
    • 方法详细信息

      • getRealm

        public String getRealm​()
        返回此BasicAuthenticator创建的领域
        结果
        验证者的领域字符串。
      • authenticate

        public Authenticator.Result authenticate​(HttpExchange t)
        描述从类复制: Authenticator
        被要求验证每个传入的请求。 实施必须返回失败,成功或重试对象: -

        失败意味着验证已完成,但由于凭据无效而失败。

        Sucess意味着认证成功,并且可以通过调用Sucess.getPrincipal()来检索表示用户的Principal对象。

        重试意味着需要另一个HTTP交换。 在给定的HttpExchange中设置需要发送回客户端的任何响应头。 必须在Retry对象中提供要返回的响应代码。 重试可能会发生多次。

        Specified by:
        authenticateAuthenticator
      • checkCredentials

        public abstract boolean checkCredentials​(String username,
                                                 String password)
        要求每个传入请求在此Authenticator的领域的上下文中验证给定的名称和密码。 凭证的任何缓存必须通过执行此方法来完成
        参数
        username - 请求中的用户名
        password - 请求中的密码
        结果
        true如果凭据有效, false否则。