Package org.apache.commons.httpclient.auth

Class BasicScheme

java.lang.Object

org.apache.commons.httpclient.auth.RFC2617Scheme

org.apache.commons.httpclient.auth.BasicScheme

All Implemented Interfaces:

AuthScheme

@Deprecated
public class BasicScheme
extends RFC2617Scheme

Deprecated.

Jakarta Commons HttpClient 3.x is deprecated in the Jenkins project. It is not recommended to use it in any new code. Instead, use HTTP client API plugins as a dependency in your code. E.g. Apache HttpComponents Client API 4.x Plugin or Async HTTP Client Plugin.

Basic authentication scheme as defined in RFC 2617.

Constructor Summary

Constructors

Constructor	Description
BasicScheme()	Deprecated. Default constructor for the basic authetication scheme.
BasicScheme(String challenge)	Deprecated. Use parameterless constructor and AuthScheme.processChallenge(String) method

Method Summary

Modifier and Type	Method	Description
String	authenticate(Credentials credentials, String method, String uri)	Deprecated. Use authenticate(Credentials, HttpMethod)
String	authenticate(Credentials credentials, HttpMethod method)	Deprecated. Produces basic authorization string for the given set of Credentials.
static String	authenticate(UsernamePasswordCredentials credentials)	Deprecated. Use authenticate(UsernamePasswordCredentials, String) Returns a basic Authorization header value for the given UsernamePasswordCredentials.
static String	authenticate(UsernamePasswordCredentials credentials, String charset)	Deprecated. Returns a basic Authorization header value for the given UsernamePasswordCredentials and charset.
String	getSchemeName()	Deprecated. Returns textual designation of the basic authentication scheme.
boolean	isComplete()	Deprecated. Tests if the Basic authentication process has been completed.
boolean	isConnectionBased()	Deprecated. Returns false.
void	processChallenge(String challenge)	Deprecated. Processes the Basic challenge.

Methods inherited from class org.apache.commons.httpclient.auth.RFC2617Scheme

getID, getParameter, getRealm

Methods inherited from class java.lang.Object

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

Constructor Details

BasicScheme

public BasicScheme()

Deprecated.

Default constructor for the basic authetication scheme.

Since:

3.0

BasicScheme

public BasicScheme(String challenge)
            throws MalformedChallengeException

Deprecated.

Use parameterless constructor and AuthScheme.processChallenge(String) method

Constructor for the basic authetication scheme.

Parameters:

challenge - authentication challenge

Throws:

MalformedChallengeException - is thrown if the authentication challenge is malformed

Method Details

getSchemeName

public String getSchemeName()

Deprecated.

Returns textual designation of the basic authentication scheme.

Returns:

basic

processChallenge

public void processChallenge(String challenge)
                      throws MalformedChallengeException

Deprecated.

Processes the Basic challenge.

Specified by:

processChallenge in interface AuthScheme

Overrides:

processChallenge in class RFC2617Scheme

Parameters:

challenge - the challenge string

Throws:

MalformedChallengeException - is thrown if the authentication challenge is malformed

Since:

3.0

isComplete

public boolean isComplete()

Deprecated.

Tests if the Basic authentication process has been completed.

Returns:

true if Basic authorization has been processed, false otherwise.

Since:

3.0

authenticate

public String authenticate(Credentials credentials,
 String method,
 String uri)
                    throws AuthenticationException

Deprecated.

Use authenticate(Credentials, HttpMethod)

Produces basic authorization string for the given set of Credentials.

Parameters:

credentials - The set of credentials to be used for athentication

method - Method name is ignored by the basic authentication scheme

uri - URI is ignored by the basic authentication scheme

Returns:

a basic authorization string

Throws:

InvalidCredentialsException - if authentication credentials are not valid or not applicable for this authentication scheme

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

See Also:

• HttpMethod.getName()
• HttpMethod.getPath()

isConnectionBased

public boolean isConnectionBased()

Deprecated.

Returns false. Basic authentication scheme is request based.

Returns:

false.

Since:

3.0

authenticate

public String authenticate(Credentials credentials,
 HttpMethod method)
                    throws AuthenticationException

Deprecated.

Produces basic authorization string for the given set of Credentials.

Parameters:

credentials - The set of credentials to be used for athentication

method - The method being authenticated

Returns:

a basic authorization string

Throws:

InvalidCredentialsException - if authentication credentials are not valid or not applicable for this authentication scheme

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

Since:

3.0

authenticate

public static String authenticate(UsernamePasswordCredentials credentials)

Deprecated.

Use authenticate(UsernamePasswordCredentials, String) Returns a basic Authorization header value for the given UsernamePasswordCredentials.

Parameters:

credentials - The credentials to encode.

Returns:

a basic authorization string

authenticate

public static String authenticate(UsernamePasswordCredentials credentials,
 String charset)

Deprecated.

Returns a basic Authorization header value for the given UsernamePasswordCredentials and charset.

Parameters:

credentials - The credentials to encode.

charset - The charset to use for encoding the credentials

Returns:

a basic authorization string

Since:

3.0