depends.org.apache.http.auth

接口 AuthScheme

所有已知子接口:

ContextAwareAuthScheme

所有已知实现类:

AuthSchemeBase, BasicScheme, DigestScheme, GGSSchemeBase, KerberosScheme, NegotiateScheme, NTLMScheme, RFC2617Scheme, SPNegoScheme

public interface AuthScheme

This interface represents an abstract challenge-response oriented authentication scheme.

An authentication scheme should be able to support the following functions:

• Parse and process the challenge sent by the target server in response to request for a protected resource
• Provide its textual designation
• Provide its parameters, if available
• Provide the realm this authentication scheme is applicable to, if available
• Generate authorization string for the given set of credentials and the HTTP request in response to the authorization challenge.

Authentication schemes may be stateful involving a series of challenge-response exchanges.

IMPORTANT: implementations of this interface MUST also implement ContextAwareAuthScheme interface in order to remain API compatible with newer versions of HttpClient.

从以下版本开始:

4.0

方法概要

方法

限定符和类型	方法和说明
Header	authenticate(Credentials credentials, HttpRequest request) 已过时。 (4.1) Use ContextAwareAuthScheme.authenticate(Credentials, HttpRequest, depends.org.apache.http.protocol.HttpContext)
java.lang.String	getParameter(java.lang.String name) Returns authentication parameter with the given name, if available.
java.lang.String	getRealm() Returns authentication realm.
java.lang.String	getSchemeName() Returns textual designation of the given authentication scheme.
boolean	isComplete() Authentication process may involve a series of challenge-response exchanges.
boolean	isConnectionBased() Tests if the authentication scheme is provides authorization on a per connection basis instead of usual per request basis
void	processChallenge(Header header) Processes the given challenge token.

方法详细资料

processChallenge

void processChallenge(Header header)
                      throws MalformedChallengeException

Processes the given challenge token. Some authentication schemes may involve multiple challenge-response exchanges. Such schemes must be able to maintain the state information when dealing with sequential challenges

参数:

header - the challenge header

抛出:

MalformedChallengeException

getSchemeName

java.lang.String getSchemeName()

Returns textual designation of the given authentication scheme.

返回:

the name of the given authentication scheme

getParameter

java.lang.String getParameter(java.lang.String name)

Returns authentication parameter with the given name, if available.

参数:

name - The name of the parameter to be returned

返回:

the parameter with the given name

getRealm

java.lang.String getRealm()

Returns authentication realm. If the concept of an authentication realm is not applicable to the given authentication scheme, returns null.

返回:

the authentication realm

isConnectionBased

boolean isConnectionBased()

Tests if the authentication scheme is provides authorization on a per connection basis instead of usual per request basis

返回:

true if the scheme is connection based, false if the scheme is request based.

isComplete

boolean isComplete()

Authentication process may involve a series of challenge-response exchanges. This method tests if the authorization process has been completed, either successfully or unsuccessfully, that is, all the required authorization challenges have been processed in their entirety.

返回:

true if the authentication process has been completed, false otherwise.

authenticate

@Deprecated
Header authenticate(Credentials credentials,
                             HttpRequest request)
                    throws AuthenticationException

已过时。 (4.1) Use ContextAwareAuthScheme.authenticate(Credentials, HttpRequest, depends.org.apache.http.protocol.HttpContext)

Produces an authorization string for the given set of Credentials.

参数:

credentials - The set of credentials to be used for athentication

request - The request being authenticated

返回:

the authorization string

抛出:

AuthenticationException - if authorization string cannot be generated due to an authentication failure