com.dropbox.client2.android

Class AuthActivity

java.lang.Object

android.content.Context

android.content.ContextWrapper

android.view.ContextThemeWrapper

android.app.Activity

com.dropbox.client2.android.AuthActivity

All Implemented Interfaces:

android.content.ComponentCallbacks, android.view.KeyEvent.Callback, android.view.LayoutInflater.Factory, android.view.View.OnCreateContextMenuListener, android.view.Window.Callback

public class AuthActivity
extends android.app.Activity

This activity is used internally for authentication, but must be exposed both so that Android can launch it and for backwards compatibility.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	AuthActivity.SecurityProvider Provider of the local security needs of an AuthActivity.

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	ACTION_AUTHENTICATE_V1 The Android action which the official Dropbox app will accept to authenticate a user.
static java.lang.String	ACTION_AUTHENTICATE_V2 The Android action which the official Dropbox app will accept to authenticate a user.
static java.lang.String	AUTH_PATH_CONNECT The path for a successful callback with token (not the initial auth request).
static int	AUTH_VERSION The version of the API for the web-auth callback with token (not the initial auth request).
static java.lang.String	EXTRA_ACCESS_SECRET The extra that goes in an intent when returning from Dropbox auth to provide the user's access token secret, if auth succeeded.
static java.lang.String	EXTRA_ACCESS_TOKEN The extra that goes in an intent when returning from Dropbox auth to provide the user's access token, if auth succeeded.
static java.lang.String	EXTRA_AUTH_STATE Used for internal authentication.
static java.lang.String	EXTRA_CALLING_CLASS Used for internal authentication.
static java.lang.String	EXTRA_CALLING_PACKAGE Used for internal authentication.
static java.lang.String	EXTRA_CONSUMER_KEY The extra that goes in an intent to provide your consumer key for Dropbox authentication.
static java.lang.String	EXTRA_CONSUMER_SIG Used for internal authentication.
static java.lang.String	EXTRA_UID The extra that goes in an intent when returning from Dropbox auth to provide the user's Dropbox UID, if auth succeeded.
static android.content.Intent	result Used internally.

Fields inherited from class android.app.Activity

DEFAULT_KEYS_DIALER, DEFAULT_KEYS_DISABLE, DEFAULT_KEYS_SEARCH_GLOBAL, DEFAULT_KEYS_SEARCH_LOCAL, DEFAULT_KEYS_SHORTCUT, FOCUSED_STATE_SET, RESULT_CANCELED, RESULT_FIRST_USER, RESULT_OK

Fields inherited from class android.content.Context

ACCESSIBILITY_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, AUDIO_SERVICE, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, CLIPBOARD_SERVICE, CONNECTIVITY_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESTRICTED, INPUT_METHOD_SERVICE, KEYGUARD_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MODE_APPEND, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NOTIFICATION_SERVICE, POWER_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, TELEPHONY_SERVICE, VIBRATOR_SERVICE, WALLPAPER_SERVICE, WIFI_SERVICE, WINDOW_SERVICE

Constructor Summary

Constructors

Constructor and Description
AuthActivity()

Method Summary

Methods

Modifier and Type	Method and Description
static boolean	checkAppBeforeAuth(android.content.Context context, java.lang.String appKey, boolean alertUser) Check's the current app's manifest setup for authentication.
static android.content.Intent	makeIntent(android.content.Context context, java.lang.String appKey, java.lang.String appSecret, java.lang.String webHost, java.lang.String apiType) Deprecated. Use makeOAuth2Intent(android.content.Context, java.lang.String, java.lang.String, java.lang.String)
static android.content.Intent	makeOAuth2Intent(android.content.Context context, java.lang.String appKey, java.lang.String webHost, java.lang.String apiType) Create an intent which can be sent to this activity to start OAuth 2 authentication.
protected void	onCreate(android.os.Bundle savedInstanceState)
protected void	onNewIntent(android.content.Intent intent)
protected void	onResume()
protected void	onSaveInstanceState(android.os.Bundle outState)
static void	setSecurityProvider(AuthActivity.SecurityProvider prov) Sets the SecurityProvider interface to use for all AuthActivity instances.

Methods inherited from class android.app.Activity

addContentView, closeContextMenu, closeOptionsMenu, createPendingResult, dismissDialog, dispatchKeyEvent, dispatchPopulateAccessibilityEvent, dispatchTouchEvent, dispatchTrackballEvent, finalize, findViewById, finish, finishActivity, finishActivityFromChild, finishFromChild, getApplication, getCallingActivity, getCallingPackage, getChangingConfigurations, getComponentName, getCurrentFocus, getInstanceCount, getIntent, getLastNonConfigurationInstance, getLayoutInflater, getLocalClassName, getMenuInflater, getParent, getPreferences, getRequestedOrientation, getSystemService, getTaskId, getTitle, getTitleColor, getVolumeControlStream, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, getWindow, getWindowManager, hasWindowFocus, isChild, isFinishing, isTaskRoot, managedQuery, moveTaskToBack, onActivityResult, onApplyThemeResource, onChildTitleChanged, onConfigurationChanged, onContentChanged, onContextItemSelected, onContextMenuClosed, onCreateContextMenu, onCreateDescription, onCreateDialog, onCreateOptionsMenu, onCreatePanelMenu, onCreatePanelView, onCreateThumbnail, onCreateView, onDestroy, onKeyDown, onKeyMultiple, onKeyUp, onLowMemory, onMenuItemSelected, onMenuOpened, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPause, onPostCreate, onPostResume, onPrepareDialog, onPrepareOptionsMenu, onPreparePanel, onRestart, onRestoreInstanceState, onRetainNonConfigurationInstance, onSearchRequested, onStart, onStop, onTitleChanged, onTouchEvent, onTrackballEvent, onUserInteraction, onUserLeaveHint, onWindowAttributesChanged, onWindowFocusChanged, openContextMenu, openOptionsMenu, registerForContextMenu, removeDialog, requestWindowFeature, runOnUiThread, setContentView, setContentView, setContentView, setDefaultKeyMode, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setIntent, setPersistent, setProgress, setProgressBarIndeterminate, setProgressBarIndeterminateVisibility, setProgressBarVisibility, setRequestedOrientation, setResult, setResult, setSecondaryProgress, setTitle, setTitle, setTitleColor, setVisible, setVolumeControlStream, showDialog, startActivity, startActivityForResult, startActivityFromChild, startActivityIfNeeded, startManagingCursor, startNextMatchingActivity, startSearch, stopManagingCursor, takeKeyEvents, unregisterForContextMenu

Methods inherited from class android.view.ContextThemeWrapper

attachBaseContext, getTheme, setTheme

Methods inherited from class android.content.ContextWrapper

bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkUriPermission, checkUriPermission, clearWallpaper, createPackageContext, databaseList, deleteDatabase, deleteFile, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getAssets, getBaseContext, getCacheDir, getClassLoader, getContentResolver, getDatabasePath, getDir, getFilesDir, getFileStreamPath, getMainLooper, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getResources, getSharedPreferences, getWallpaper, grantUriPermission, isRestricted, openFileInput, openFileOutput, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, removeStickyBroadcast, revokeUriPermission, sendBroadcast, sendBroadcast, sendOrderedBroadcast, sendOrderedBroadcast, sendStickyBroadcast, setWallpaper, setWallpaper, startInstrumentation, startService, stopService, unbindService, unregisterReceiver

Methods inherited from class android.content.Context

getString, getString, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes

Methods inherited from class java.lang.Object

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

Field Detail

EXTRA_CONSUMER_KEY

public static final java.lang.String EXTRA_CONSUMER_KEY

The extra that goes in an intent to provide your consumer key for Dropbox authentication. You won't ever have to use this.

See Also:

Constant Field Values

EXTRA_ACCESS_TOKEN

public static final java.lang.String EXTRA_ACCESS_TOKEN

The extra that goes in an intent when returning from Dropbox auth to provide the user's access token, if auth succeeded. You won't ever have to use this.

See Also:

Constant Field Values

EXTRA_ACCESS_SECRET

public static final java.lang.String EXTRA_ACCESS_SECRET

The extra that goes in an intent when returning from Dropbox auth to provide the user's access token secret, if auth succeeded. You won't ever have to use this.

See Also:

Constant Field Values

EXTRA_UID

public static final java.lang.String EXTRA_UID

The extra that goes in an intent when returning from Dropbox auth to provide the user's Dropbox UID, if auth succeeded. You won't ever have to use this.

See Also:

Constant Field Values

EXTRA_CONSUMER_SIG

public static final java.lang.String EXTRA_CONSUMER_SIG

Used for internal authentication. You won't ever have to use this.

See Also:

Constant Field Values

EXTRA_CALLING_PACKAGE

public static final java.lang.String EXTRA_CALLING_PACKAGE

Used for internal authentication. You won't ever have to use this.

See Also:

Constant Field Values

EXTRA_CALLING_CLASS

public static final java.lang.String EXTRA_CALLING_CLASS

Used for internal authentication. You won't ever have to use this.

See Also:

Constant Field Values

EXTRA_AUTH_STATE

public static final java.lang.String EXTRA_AUTH_STATE

Used for internal authentication. You won't ever have to use this.

See Also:

Constant Field Values

ACTION_AUTHENTICATE_V1

public static final java.lang.String ACTION_AUTHENTICATE_V1

The Android action which the official Dropbox app will accept to authenticate a user. You won't ever have to use this.

See Also:

Constant Field Values

ACTION_AUTHENTICATE_V2

public static final java.lang.String ACTION_AUTHENTICATE_V2

The Android action which the official Dropbox app will accept to authenticate a user. You won't ever have to use this.

See Also:

Constant Field Values

AUTH_VERSION

public static final int AUTH_VERSION

The version of the API for the web-auth callback with token (not the initial auth request).

See Also:

Constant Field Values

AUTH_PATH_CONNECT

public static final java.lang.String AUTH_PATH_CONNECT

The path for a successful callback with token (not the initial auth request).

See Also:

Constant Field Values

result

public static android.content.Intent result

Used internally.

Constructor Detail

AuthActivity

public AuthActivity()

Method Detail

makeIntent

public static android.content.Intent makeIntent(android.content.Context context,
                                java.lang.String appKey,
                                java.lang.String appSecret,
                                java.lang.String webHost,
                                java.lang.String apiType)

Deprecated. Use makeOAuth2Intent(android.content.Context, java.lang.String, java.lang.String, java.lang.String)

Create an intent which can be sent to this activity to start OAuth 1 authentication.

Parameters:

context - the source context

appKey - the consumer key for the app

appSecret - the consumer secret for the app

webHost - the host to use for web authentication, or null for the default

apiType - an identifier for the type of API being supported, or null for the default

Returns:

a newly created intent.

makeOAuth2Intent

public static android.content.Intent makeOAuth2Intent(android.content.Context context,
                                      java.lang.String appKey,
                                      java.lang.String webHost,
                                      java.lang.String apiType)

Create an intent which can be sent to this activity to start OAuth 2 authentication.

Parameters:

context - the source context

appKey - the consumer key for the app

webHost - the host to use for web authentication, or null for the default

apiType - an identifier for the type of API being supported, or null for the default

Returns:

a newly created intent.

checkAppBeforeAuth

public static boolean checkAppBeforeAuth(android.content.Context context,
                         java.lang.String appKey,
                         boolean alertUser)

Check's the current app's manifest setup for authentication. If the manifest is incorrect, an exception will be thrown. If another app on the device is conflicting with this one, the user will (optionally) be alerted and false will be returned.

Parameters:

context - the app context

appKey - the consumer key for the app

alertUser - whether to alert the user for the case where multiple apps are conflicting.

Returns:

true if this app is properly set up for authentication.

setSecurityProvider

public static void setSecurityProvider(AuthActivity.SecurityProvider prov)

Sets the SecurityProvider interface to use for all AuthActivity instances. If set to null (or never set at all), default java.security providers will be used instead.

You shouldn't need to use this method directly in your app. Instead, simply configure java.security's providers to match your preferences.

Parameters:

prov - the new SecurityProvider interface.

onCreate

protected void onCreate(android.os.Bundle savedInstanceState)

Overrides:

onCreate in class android.app.Activity

onSaveInstanceState

protected void onSaveInstanceState(android.os.Bundle outState)

Overrides:

onSaveInstanceState in class android.app.Activity

onResume

protected void onResume()

Overrides:

onResume in class android.app.Activity

onNewIntent

protected void onNewIntent(android.content.Intent intent)

Overrides:

onNewIntent in class android.app.Activity