org.jboss.aerogear.android.authentication.digest

Class HttpDigestAuthenticationModule

java.lang.Object

org.jboss.aerogear.android.authentication.AbstractAuthenticationModule

org.jboss.aerogear.android.authentication.digest.HttpDigestAuthenticationModule

All Implemented Interfaces:

AuthenticationModule, org.jboss.aerogear.android.pipe.module.PipeModule

public class HttpDigestAuthenticationModule
extends AbstractAuthenticationModule

This class provides Authentication using HTTP Digest As per the HTTP RFC this class will cache credentials and consumed by Pipe requests. This module assumes that credentials provided are valid and will never fail on login(java.lang.String, java.lang.String, org.jboss.aerogear.android.core.Callback) or logout(org.jboss.aerogear.android.core.Callback). enroll(java.util.Map, org.jboss.aerogear.android.core.Callback) is not supported and will always fail.

Field Summary

Fields inherited from class org.jboss.aerogear.android.authentication.AbstractAuthenticationModule

PASSWORD_PARAMETER_NAME, THREAD_POOL_EXECUTOR, USERNAME_PARAMETER_NAME

Constructor Summary

Constructors

Constructor and Description
HttpDigestAuthenticationModule(URL baseURL, String loginEndpoint, String logoutEndpoint, Integer timeout)

Method Summary

Modifier and Type	Method and Description
void	enroll(Map<String,String> userData, org.jboss.aerogear.android.core.Callback<org.jboss.aerogear.android.pipe.http.HeaderAndBody> callback) Will try to register a user with a service using userData.
URL	getBaseURL()
String	getEnrollEndpoint()
String	getLoginEndpoint()
String	getLogoutEndpoint()
boolean	handleError(org.jboss.aerogear.android.pipe.http.HttpException exception)
boolean	isLoggedIn()
org.jboss.aerogear.android.pipe.module.ModuleFields	loadModule(URI relativeURI, String httpMethod, byte[] requestBody)
void	login(Map<String,String> loginData, org.jboss.aerogear.android.core.Callback<org.jboss.aerogear.android.pipe.http.HeaderAndBody> callback) Will try to log in a user It will call the callbacks onSuccess with a parameter of a Map of the values returned by the enroll service or onFailure if there is an error
void	login(String username, String password, org.jboss.aerogear.android.core.Callback<org.jboss.aerogear.android.pipe.http.HeaderAndBody> callback) Will try to log in a user using username and password.
void	logout(org.jboss.aerogear.android.core.Callback<Void> callback) Performs a logout of the current user.

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpDigestAuthenticationModule

public HttpDigestAuthenticationModule(URL baseURL,
                                      String loginEndpoint,
                                      String logoutEndpoint,
                                      Integer timeout)

Parameters:

baseURL - the url that the other endpoints (enroll, login, eyc) will be appended to

loginEndpoint - the login Endpoint

logoutEndpoint - the logout Endpoint

timeout - the timeout

Throws:

IllegalArgumentException - if an endpoint can not be appended to baseURL

Method Detail

getBaseURL

public URL getBaseURL()

getLoginEndpoint

public String getLoginEndpoint()

getLogoutEndpoint

public String getLogoutEndpoint()

getEnrollEndpoint

public String getEnrollEndpoint()

enroll

public void enroll(Map<String,String> userData,
                   org.jboss.aerogear.android.core.Callback<org.jboss.aerogear.android.pipe.http.HeaderAndBody> callback)

Description copied from interface: AuthenticationModule

Will try to register a user with a service using userData. It will call the callbacks onSuccess with a parameter of a Map of the values returned by the enroll service or onFailure if there is an error

Specified by:

enroll in interface AuthenticationModule

Overrides:

enroll in class AbstractAuthenticationModule

Parameters:

userData - a collection of data to be passed to the server.

callback - a callback which will handle the server response.

login

public void login(String username,
                  String password,
                  org.jboss.aerogear.android.core.Callback<org.jboss.aerogear.android.pipe.http.HeaderAndBody> callback)

Description copied from interface: AuthenticationModule

Will try to log in a user using username and password. It will call the callbacks onSuccess with a parameter of a Map of the values returned by the enroll service or onFailure if there is an error

Specified by:

login in interface AuthenticationModule

Overrides:

login in class AbstractAuthenticationModule

Parameters:

username - the users userName

password - the users Password

callback - a callback which will handle the server response.

logout

public void logout(org.jboss.aerogear.android.core.Callback<Void> callback)

Description copied from interface: AuthenticationModule

Performs a logout of the current user. It will call callback.onSuccess with no value on success and callback.onFailure if there is an error.

Specified by:

logout in interface AuthenticationModule

Overrides:

logout in class AbstractAuthenticationModule

Parameters:

callback - a callback which will handle the server response.

isLoggedIn

public boolean isLoggedIn()

Returns:

true if the module has been logged in successfully

login

public void login(Map<String,String> loginData,
                  org.jboss.aerogear.android.core.Callback<org.jboss.aerogear.android.pipe.http.HeaderAndBody> callback)

Will try to log in a user It will call the callbacks onSuccess with a parameter of a Map of the values returned by the enroll service or onFailure if there is an error

Parameters:

loginData - a map of data which will be passed to the server

callback - a callback which will handle the server response.

loadModule

public org.jboss.aerogear.android.pipe.module.ModuleFields loadModule(URI relativeURI,
                                                                      String httpMethod,
                                                                      byte[] requestBody)

handleError

public boolean handleError(org.jboss.aerogear.android.pipe.http.HttpException exception)