org.jboss.aerogear.android.authentication.basic

Class HttpBasicAuthenticationModule

java.lang.Object

org.jboss.aerogear.android.authentication.AbstractAuthenticationModule

org.jboss.aerogear.android.authentication.basic.HttpBasicAuthenticationModule

All Implemented Interfaces:

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

public class HttpBasicAuthenticationModule
extends AbstractAuthenticationModule

This class provides Authentication using HTTP Basic 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
HttpBasicAuthenticationModule(URL baseURL)

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) Enrolling is not supported using http basic.
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) This will log in the user using the keys "loginName" and "password".
void	login(String username, String password, org.jboss.aerogear.android.core.Callback<org.jboss.aerogear.android.pipe.http.HeaderAndBody> callback) This method stores username and password.
void	logout(org.jboss.aerogear.android.core.Callback<Void> callback) This method clears the username and password from the module, sets isLoggedIn to false, and removes all cookies associated with baseURL This method always calls Callback.onSuccess(java.lang.Object)

Methods inherited from class java.lang.Object

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

Constructor Detail

HttpBasicAuthenticationModule

public HttpBasicAuthenticationModule(URL baseURL)

Parameters:

baseURL - The base URL shared by a Pipe.

Method Detail

getBaseURL

public URL getBaseURL()

getLoginEndpoint

public String getLoginEndpoint()

getLogoutEndpoint

public String getLogoutEndpoint()

getEnrollEndpoint

public String getEnrollEndpoint()

isLoggedIn

public boolean isLoggedIn()

Returns:

true if the module has been logged in successfully

login

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

This method stores username and password. Additionally, it sets isLoggedIn to true and calls immediately * .

Specified by:

login in interface AuthenticationModule

Overrides:

login in class AbstractAuthenticationModule

Parameters:

username - the username of the user

password - the password of the user

callback - a callback to handle the result.

logout

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

This method clears the username and password from the module, sets isLoggedIn to false, and removes all cookies associated with baseURL This method always calls Callback.onSuccess(java.lang.Object)

Specified by:

logout in interface AuthenticationModule

Overrides:

logout in class AbstractAuthenticationModule

Parameters:

callback - the callback whose onsuccess method will be executed

enroll

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

Enrolling is not supported using http basic. This method will call Callback.onFailure(java.lang.Exception) and pass it a UnsupportedOperationException.

Specified by:

enroll in interface AuthenticationModule

Overrides:

enroll in class AbstractAuthenticationModule

Parameters:

userData - this value is ignored.

callback - the callback to be called

login

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

This will log in the user using the keys "loginName" and "password".

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)