com.box.androidsdk.content.auth

Class BoxAuthentication

java.lang.Object

com.box.androidsdk.content.auth.BoxAuthentication

public class BoxAuthentication
extends java.lang.Object

Handles authentication and stores authentication information.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	BoxAuthentication.AuthListener Interface of a listener to listen to authentication events.
static class	BoxAuthentication.AuthStorage Storage class to store auth info.
static class	BoxAuthentication.BoxAuthenticationInfo Object holding authentication info.
static class	BoxAuthentication.NonDefaultClientLogoutException Exception if user cannot be logged out using the default BoxConfig client id/secret.

Field Summary

Fields

Modifier and Type	Field and Description
static java.util.concurrent.ThreadPoolExecutor	AUTH_EXECUTOR

Method Summary

Methods

Modifier and Type	Method and Description
void	addListener(BoxAuthentication.AuthListener listener) Add listener to listen to the authentication process for this BoxSession.
BoxAuthentication.BoxAuthenticationInfo	getAuthInfo(java.lang.String userId, android.content.Context context) Get the BoxAuthenticationInfo for a given user.
BoxAuthentication.AuthStorage	getAuthStorage() Get the auth storage used to store auth information.
static BoxAuthentication	getInstance() Get singleton instance of the BoxAuthentication object.
java.lang.String	getLastAuthenticatedUserId(android.content.Context context) Get the user id that was last authenticated.
java.util.Map<java.lang.String,BoxAuthentication.BoxAuthenticationInfo>	getStoredAuthInfo(android.content.Context context) Get a map of all stored auth information.
void	logout(BoxSession session) Log out current BoxSession.
void	logoutAllUsers(android.content.Context context) Log out all users.
void	onAuthenticated(BoxAuthentication.BoxAuthenticationInfo info, android.content.Context context) Callback method to be called when authentication process finishes.
void	onAuthenticationFailure(BoxAuthentication.BoxAuthenticationInfo info, java.lang.Exception ex) Callback method to be called if authentication process fails.
void	onLoggedOut(BoxAuthentication.BoxAuthenticationInfo info, java.lang.Exception ex) Callback method to be called on logout.
void	refresh(BoxSession session) Refresh the OAuth in the given BoxSession.
void	setAuthStorage(BoxAuthentication.AuthStorage storage) Set the storage to store auth information.
protected void	startAuthenticateUI(BoxSession session, boolean viaBoxApp) Start authentication UI.
void	startAuthenticationUI(BoxSession session)
protected void	startAuthenticationUsingBoxApp(BoxSession session) Start box android app to authenticate.

Methods inherited from class java.lang.Object

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

Field Detail

AUTH_EXECUTOR

public static final java.util.concurrent.ThreadPoolExecutor AUTH_EXECUTOR

Method Detail

getAuthInfo

public BoxAuthentication.BoxAuthenticationInfo getAuthInfo(java.lang.String userId,
                                                  android.content.Context context)

Get the BoxAuthenticationInfo for a given user.

getStoredAuthInfo

public java.util.Map<java.lang.String,BoxAuthentication.BoxAuthenticationInfo> getStoredAuthInfo(android.content.Context context)

Get a map of all stored auth information.

Parameters:

context - current context.

Returns:

a map with all stored user information, or null if no user info has been stored.

getLastAuthenticatedUserId

public java.lang.String getLastAuthenticatedUserId(android.content.Context context)

Get the user id that was last authenticated.

Parameters:

context - current context.

Returns:

the user id that was last authenticated or null if it does not exist or was removed.

getInstance

public static BoxAuthentication getInstance()

Get singleton instance of the BoxAuthentication object.

setAuthStorage

public void setAuthStorage(BoxAuthentication.AuthStorage storage)

Set the storage to store auth information. By default, sharedpref is used. You can use this method to use your own storage class that extends the AuthStorage.

getAuthStorage

public BoxAuthentication.AuthStorage getAuthStorage()

Get the auth storage used to store auth information.

startAuthenticationUI

public void startAuthenticationUI(BoxSession session)

startAuthenticationUsingBoxApp

protected void startAuthenticationUsingBoxApp(BoxSession session)

Start box android app to authenticate. Make this method public when box android app supports this.

onAuthenticated

public void onAuthenticated(BoxAuthentication.BoxAuthenticationInfo info,
                   android.content.Context context)

Callback method to be called when authentication process finishes.

onAuthenticationFailure

public void onAuthenticationFailure(BoxAuthentication.BoxAuthenticationInfo info,
                           java.lang.Exception ex)

Callback method to be called if authentication process fails.

onLoggedOut

public void onLoggedOut(BoxAuthentication.BoxAuthenticationInfo info,
               java.lang.Exception ex)

Callback method to be called on logout.

logout

public void logout(BoxSession session)
            throws BoxException

Log out current BoxSession. After logging out, the authentication information related to the Box user in this session will be gone.

Throws:

BoxException

logoutAllUsers

public void logoutAllUsers(android.content.Context context)

Log out all users. After logging out, all authentication information will be gone.

refresh

public void refresh(BoxSession session)
             throws BoxException

Refresh the OAuth in the given BoxSession. This method is called when OAuth token expires.

Throws:

BoxException

addListener

public void addListener(BoxAuthentication.AuthListener listener)

Add listener to listen to the authentication process for this BoxSession.

startAuthenticateUI

protected void startAuthenticateUI(BoxSession session,
                       boolean viaBoxApp)

Start authentication UI.

Parameters:

viaBoxApp - true if you want to authenticate through installed box android app., otherwise use false.