Package org.restlet.data

Class ChallengeMessage

java.lang.Object

org.restlet.data.ChallengeMessage

Direct Known Subclasses:

ChallengeRequest, ChallengeResponse

public abstract class ChallengeMessage
extends Object

Base authentication challenge message exchanged between an origin server and a client.

Author:

Jerome Louvel

Field Summary

Fields

Modifier and Type	Field	Description
static final String	QUALITY_AUTHENTICATION	Authentication quality.
static final String	QUALITY_AUTHENTICATION_INTEGRITY	Authentication and integrity.

Constructor Summary

Constructors

Constructor	Description
ChallengeMessage(ChallengeScheme scheme)	Constructor.
ChallengeMessage(ChallengeScheme scheme, String realm)	Constructor.
ChallengeMessage(ChallengeScheme scheme, String realm, Series<Parameter> parameters)	Constructor.
ChallengeMessage(ChallengeScheme scheme, String realm, Series<Parameter> parameters, String digestAlgorithm, String opaque, String serverNonce)	Constructor.
ChallengeMessage(ChallengeScheme scheme, Series<Parameter> parameters)	Constructor.

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)
String	getDigestAlgorithm()	Returns the digest algorithm.
String	getOpaque()	Returns an opaque string of data which should be returned by the client unchanged.
Series<Parameter>	getParameters()	Returns the modifiable series of scheme parameters.
String	getRawValue()	Returns the raw challenge value.
String	getRealm()	Returns the realm name.
ChallengeScheme	getScheme()	Returns the scheme used.
String	getServerNonce()	Returns the server nonce.
int	hashCode()
void	setDigestAlgorithm(String digestAlgorithm)	Sets the digest algorithm.
void	setOpaque(String opaque)	Sets an opaque string of data which should be returned by the client unchanged.
void	setParameters(Series<Parameter> parameters)	Sets the parameters.
void	setRawValue(String rawValue)	Sets the raw value.
void	setRealm(String realm)	Sets the realm name.
void	setScheme(ChallengeScheme scheme)	Sets the scheme used.
void	setServerNonce(String serverNonce)	Sets the server nonce.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Field Details

QUALITY_AUTHENTICATION

public static final String QUALITY_AUTHENTICATION

Authentication quality.

See Also:

• Constant Field Values

QUALITY_AUTHENTICATION_INTEGRITY

public static final String QUALITY_AUTHENTICATION_INTEGRITY

Authentication and integrity.

See Also:

• Constant Field Values

Constructor Details

ChallengeMessage

public ChallengeMessage(ChallengeScheme scheme)

Constructor.

Parameters:

scheme - The challenge scheme.

ChallengeMessage

public ChallengeMessage(ChallengeScheme scheme,
 Series<Parameter> parameters)

Constructor.

Parameters:

scheme - The challenge scheme.

parameters - The additional scheme parameters.

ChallengeMessage

public ChallengeMessage(ChallengeScheme scheme,
 String realm)

Constructor.

Parameters:

scheme - The challenge scheme.

realm - The authentication realm.

ChallengeMessage

public ChallengeMessage(ChallengeScheme scheme,
 String realm,
 Series<Parameter> parameters)

Constructor.

Parameters:

scheme - The challenge scheme.

realm - The authentication realm.

parameters - The additional scheme parameters.

ChallengeMessage

public ChallengeMessage(ChallengeScheme scheme,
 String realm,
 Series<Parameter> parameters,
 String digestAlgorithm,
 String opaque,
 String serverNonce)

Constructor.

Parameters:

scheme - The challenge scheme.

realm - The authentication realm.

parameters - The additional scheme parameters.

digestAlgorithm - The digest algorithm.

opaque - An opaque string of data which should be returned by the client unchanged.

serverNonce - The server nonce.

Method Details

equals

public boolean equals(Object obj)

Overrides:

equals in class Object

getDigestAlgorithm

public String getDigestAlgorithm()

Returns the digest algorithm. See Digest class for DIGEST_* constants. Default value is Digest.ALGORITHM_MD5.

Returns:

The digest algorithm.

getOpaque

public String getOpaque()

Returns an opaque string of data which should be returned by the client unchanged.

Returns:

An opaque string of data.

getParameters

public Series<Parameter> getParameters()

Returns the modifiable series of scheme parameters. Creates a new instance if no one has been set.

Returns:

The modifiable series of scheme parameters.

getRawValue

public String getRawValue()

Returns the raw challenge value.

Returns:

The raw challenge value.

getRealm

public String getRealm()

Returns the realm name.

Returns:

The realm name.

getScheme

public ChallengeScheme getScheme()

Returns the scheme used.

Returns:

The scheme used.

getServerNonce

public String getServerNonce()

Returns the server nonce.

Returns:

The server nonce.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

setDigestAlgorithm

public void setDigestAlgorithm(String digestAlgorithm)

Sets the digest algorithm. See Digest class for ALGORITHM_* constants. Default value is Digest.ALGORITHM_MD5.

Parameters:

digestAlgorithm - The digest algorithm.

setOpaque

public void setOpaque(String opaque)

Sets an opaque string of data which should be returned by the client unchanged.

Parameters:

opaque - An opaque string of data.

setParameters

public void setParameters(Series<Parameter> parameters)

Sets the parameters.

Parameters:

parameters - The parameters.

setRawValue

public void setRawValue(String rawValue)

Sets the raw value.

Parameters:

rawValue - The raw value.

setRealm

public void setRealm(String realm)

Sets the realm name.

Parameters:

realm - The realm name.

setScheme

public void setScheme(ChallengeScheme scheme)

Sets the scheme used.

Parameters:

scheme - The scheme used.

setServerNonce

public void setServerNonce(String serverNonce)

Sets the server nonce.

Parameters:

serverNonce - The server nonce.