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上下文。