org.apache.http.client

## Interface AuthenticationStrategy

- 所有已知实现类：
    ProxyAuthenticationStrategy ， TargetAuthenticationStrategy

      public interface AuthenticationStrategy

  / **用于确定HTTP响应是否表示由于身份验证失败而发送回客户端的身份验证挑战的处理程序。

  此接口的实现必须是线程安全的。 必须同步访问共享数据，因为可以从多个线程执行此接口的方法。

  从以下版本开始：
    4.2

- - ### 方法摘要

    Methods
    Modifier and Type | Method and Description
    --- | ---
    `void` | `authFailed(HttpHost authhost, AuthScheme authScheme, HttpContext context)` 在不成功的身份验证的情况下调用回调。
    `void` | `authSucceeded(HttpHost authhost, AuthScheme authScheme, HttpContext context)` 在成功验证的情况下调用回调。
    `Map<String,Header>` | `getChallenges(HttpHost authhost, HttpResponse response, HttpContext context)` 从给定的HTTP响应中提取认证挑战的集合，每个认证挑战表示认证主机支持的认证方案。
    `boolean` | `isAuthenticationRequested(HttpHost authhost, HttpResponse response, HttpContext context)` 确定给定的HTTP响应响应是否表示由于身份验证失败而发回的身份验证挑战。
    `Queue<AuthOption>` | `select(Map<String,Header> challenges, HttpHost authhost, HttpResponse response, HttpContext context)` 从所有可用的中选择一个认证挑战，并创建并生成能处理该挑战的`AuthOption`实例。

- - ### 方法详细信息

    - #### isAuthenticationRequested

          boolean isAuthenticationRequested(HttpHost authhost,
                                          HttpResponse response,
                                          HttpContext context)

      确定给定的HTTP响应响应是否表示由于身份验证失败而发回的身份验证挑战。
      参数
        `authhost` - 认证主机。
        `response` - HTTP响应。
        `context` - HTTP上下文。
      结果
        `true`如果需要用户认证，否则为 `false` 。

    - #### getChallenges

          Map<String,Header> getChallenges(HttpHost authhost,
                                         HttpResponse response,
                                         HttpContext context)
                                           throws MalformedChallengeException

      从给定的HTTP响应中提取认证挑战的集合，每个认证挑战表示认证主机支持的认证方案。
      参数
        `authhost` - 认证主机。
        `response` - HTTP响应。
        `context` - HTTP上下文。
      结果
        一系列由相应认证方案名称所挑战的挑战。
      异常
        `MalformedChallengeException` - 如果其中一个认证挑战无效或畸形。

    - #### select

          Queue<AuthOption> select(Map<String,Header> challenges,
                                 HttpHost authhost,
                                 HttpResponse response,
                                 HttpContext context)
                                   throws MalformedChallengeException

      从所有可用的中选择一个认证挑战，并创建并生成能够处理该挑战的`AuthOption`实例。
      参数
        `challenges` - 挑战的集合。
        `authhost` - 认证主机。
        `response` - HTTP响应。
        `context` - HTTP上下文。
      结果
        可用于认证的身份验证身份验证方案。 可以是空的
      异常
        `MalformedChallengeException` - 如果其中一个认证挑战无效或格式不正确。

    - #### authSucceeded

          void authSucceeded(HttpHost authhost,
                           AuthScheme authScheme,
                           HttpContext context)

      在成功验证的情况下调用回调。
      参数
        `authhost` - 认证主机。
        `authScheme` - 使用认证方案。
        `context` - HTTP上下文。

    - #### authFailed

          void authFailed(HttpHost authhost,
                        AuthScheme authScheme,
                        HttpContext context)

      在不成功的身份验证的情况下调用回调。
      参数
        `authhost` - 认证主机。
        `authScheme` - 使用认证方案。
        `context` - HTTP上下文。

Copyright © 1999–2017 The Apache Software Foundation. All rights reserved.

本帮助文档是使用 《谷歌翻译》翻译，请与英文版配合使用 by--QQ:654638585