Package org.eclipse.jetty.client.util

Class BasicAuthentication

java.lang.Object

org.eclipse.jetty.client.util.AbstractAuthentication

org.eclipse.jetty.client.util.BasicAuthentication

All Implemented Interfaces:

Authentication

public class BasicAuthentication
extends AbstractAuthentication

Implementation of the HTTP "Basic" authentication defined in RFC 2617.

Applications should create objects of this class and add them to the AuthenticationStore retrieved from the HttpClient via HttpClient.getAuthenticationStore().

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	BasicAuthentication.BasicResult	Basic authentication result.

Nested classes/interfaces inherited from interface org.eclipse.jetty.client.api.Authentication

Authentication.HeaderInfo, Authentication.Result

Field Summary

Fields inherited from interface org.eclipse.jetty.client.api.Authentication

ANY_REALM

Constructor Summary

Constructors

Constructor	Description
BasicAuthentication(java.net.URI uri, java.lang.String realm, java.lang.String user, java.lang.String password)

Method Summary

Modifier and Type	Method	Description
Authentication.Result	authenticate(Request request, ContentResponse response, Authentication.HeaderInfo headerInfo, Attributes context)	Executes the authentication mechanism for the given request, returning a Authentication.Result that can be used to actually authenticate the request via Authentication.Result.apply(Request).
java.lang.String	getType()

Methods inherited from class org.eclipse.jetty.client.util.AbstractAuthentication

getRealm, getURI, matches, matchesURI

Methods inherited from class java.lang.Object

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

Constructor Detail

BasicAuthentication

public BasicAuthentication(java.net.URI uri,
                           java.lang.String realm,
                           java.lang.String user,
                           java.lang.String password)

Parameters:

uri - the URI to match for the authentication

realm - the realm to match for the authentication

user - the user that wants to authenticate

password - the password of the user

Method Detail

getType

public java.lang.String getType()

Specified by:

getType in class AbstractAuthentication

authenticate

public Authentication.Result authenticate(Request request,
                                          ContentResponse response,
                                          Authentication.HeaderInfo headerInfo,
                                          Attributes context)

Description copied from interface: Authentication

Executes the authentication mechanism for the given request, returning a Authentication.Result that can be used to actually authenticate the request via Authentication.Result.apply(Request).

If a request for "/secure" returns a Authentication.Result, then the result may be used for other requests such as "/secure/foo" or "/secure/bar", unless those resources are protected by other realms.

Parameters:

request - the request to execute the authentication mechanism for

response - the 401 response obtained in the previous attempt to request the protected resource

headerInfo - the WWW-Authenticate (or Proxy-Authenticate) header chosen for this authentication (among the many that the response may contain)

context - the conversation context in case the authentication needs multiple exchanges to be completed and information needs to be stored across exchanges

Returns:

the authentication result, or null if the authentication could not be performed