org.jboss.aerogear.android.impl.authz.oauth2

Class OAuth2AuthzService

java.lang.Object

android.content.Context

android.content.ContextWrapper

android.app.Service

org.jboss.aerogear.android.impl.authz.oauth2.OAuth2AuthzService

All Implemented Interfaces:

android.content.ComponentCallbacks, android.content.ComponentCallbacks2

public class OAuth2AuthzService
extends android.app.Service

This service manages tokens for Authorization sessions. It can also perform basic OAuth2 Access Token/ Authorization exchange and manages refresh tokens.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	OAuth2AuthzService.AGAuthzServiceConnection Defines callbacks for service binding, passed to bindService()
static class	OAuth2AuthzService.AuthzBinder

Field Summary

Fields inherited from class android.app.Service

START_CONTINUATION_MASK, START_FLAG_REDELIVERY, START_FLAG_RETRY, START_NOT_STICKY, START_REDELIVER_INTENT, START_STICKY, START_STICKY_COMPATIBILITY

Fields inherited from class android.content.Context

ACCESSIBILITY_SERVICE, ACCOUNT_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, APP_OPS_SERVICE, AUDIO_SERVICE, BIND_ABOVE_CLIENT, BIND_ADJUST_WITH_ACTIVITY, BIND_ALLOW_OOM_MANAGEMENT, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BIND_IMPORTANT, BIND_NOT_FOREGROUND, BIND_WAIVE_PRIORITY, BLUETOOTH_SERVICE, CAPTIONING_SERVICE, CLIPBOARD_SERVICE, CONNECTIVITY_SERVICE, CONSUMER_IR_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESTRICTED, DEVICE_POLICY_SERVICE, DISPLAY_SERVICE, DOWNLOAD_SERVICE, DROPBOX_SERVICE, INPUT_METHOD_SERVICE, INPUT_SERVICE, KEYGUARD_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MEDIA_ROUTER_SERVICE, MODE_APPEND, MODE_ENABLE_WRITE_AHEAD_LOGGING, MODE_MULTI_PROCESS, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NFC_SERVICE, NOTIFICATION_SERVICE, NSD_SERVICE, POWER_SERVICE, PRINT_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, STORAGE_SERVICE, TELEPHONY_SERVICE, TEXT_SERVICES_MANAGER_SERVICE, UI_MODE_SERVICE, USB_SERVICE, USER_SERVICE, VIBRATOR_SERVICE, WALLPAPER_SERVICE, WIFI_P2P_SERVICE, WIFI_SERVICE, WINDOW_SERVICE

Fields inherited from interface android.content.ComponentCallbacks2

TRIM_MEMORY_BACKGROUND, TRIM_MEMORY_COMPLETE, TRIM_MEMORY_MODERATE, TRIM_MEMORY_RUNNING_CRITICAL, TRIM_MEMORY_RUNNING_LOW, TRIM_MEMORY_RUNNING_MODERATE, TRIM_MEMORY_UI_HIDDEN

Constructor Summary

Constructors

Constructor and Description
OAuth2AuthzService()

Method Summary

Modifier and Type	Method and Description
void	addAccount(OAuth2AuthzSession account) Put a session into the store.
String	fetchAccessToken(String accountId, org.jboss.aerogear.android.impl.authz.oauth2.OAuth2Properties config) This will exchange an Authorization token for an Access Token
OAuth2AuthzSession	getAccount(String accountId) Returns the OAuth2AuthzSession for accountId if any
List<String>	getAccounts() Fetches all OAuth2AuthzSessions in the system.
protected org.jboss.aerogear.android.http.HttpProvider	getHttpProvider(URL url) This method allows an implementation to change how the HttpProvider is fetched.
boolean	hasAccount(String accountId) Will check if there is an account which has previously been granted an authorization code and access code
android.os.IBinder	onBind(android.content.Intent intent)
void	onCreate()
boolean	onUnbind(android.content.Intent intent)
void	removeAccount(String accountId) Removes the account with the provided ID

Methods inherited from class android.app.Service

dump, getApplication, onConfigurationChanged, onDestroy, onLowMemory, onRebind, onStart, onStartCommand, onTaskRemoved, onTrimMemory, startForeground, stopForeground, stopSelf, stopSelf, stopSelfResult

Methods inherited from class android.content.ContextWrapper

attachBaseContext, bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkUriPermission, checkUriPermission, clearWallpaper, createConfigurationContext, createDisplayContext, createPackageContext, databaseList, deleteDatabase, deleteFile, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getAssets, getBaseContext, getCacheDir, getClassLoader, getContentResolver, getDatabasePath, getDir, getExternalCacheDir, getExternalCacheDirs, getExternalFilesDir, getExternalFilesDirs, getFilesDir, getFileStreamPath, getMainLooper, getObbDir, getObbDirs, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getResources, getSharedPreferences, getSystemService, getTheme, getWallpaper, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, grantUriPermission, isRestricted, openFileInput, openFileOutput, openOrCreateDatabase, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, removeStickyBroadcast, removeStickyBroadcastAsUser, revokeUriPermission, sendBroadcast, sendBroadcast, sendBroadcastAsUser, sendBroadcastAsUser, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcastAsUser, sendStickyBroadcast, sendStickyBroadcastAsUser, sendStickyOrderedBroadcast, sendStickyOrderedBroadcastAsUser, setTheme, setWallpaper, setWallpaper, startActivities, startActivities, startActivity, startActivity, startInstrumentation, startIntentSender, startIntentSender, startService, stopService, unbindService, unregisterReceiver

Methods inherited from class android.content.Context

getString, getString, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, registerComponentCallbacks, unregisterComponentCallbacks

Methods inherited from class java.lang.Object

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

Constructor Detail

OAuth2AuthzService

public OAuth2AuthzService()

Method Detail

onCreate

public void onCreate()

Overrides:

onCreate in class android.app.Service

fetchAccessToken

public String fetchAccessToken(String accountId,
                               org.jboss.aerogear.android.impl.authz.oauth2.OAuth2Properties config)
                        throws OAuth2AuthorizationException

This will exchange an Authorization token for an Access Token

Parameters:

accountId - the ID for the OAuth2AuthzSession

config - the config

Returns:

an accesstoken

Throws:

OAuth2AuthorizationException - if something went wrong in the exchange

addAccount

public void addAccount(OAuth2AuthzSession account)

Put a session into the store.

Parameters:

account - a new session

hasAccount

public boolean hasAccount(String accountId)

Will check if there is an account which has previously been granted an authorization code and access code

Parameters:

accountId - the accountId to check

Returns:

true if there is a session for the account.

getAccount

public OAuth2AuthzSession getAccount(String accountId)

Returns the OAuth2AuthzSession for accountId if any

Parameters:

accountId - the accountId to look up

Returns:

an OAuth2AuthzSession or null

getAccounts

public List<String> getAccounts()

Fetches all OAuth2AuthzSessions in the system.

Returns:

all OAuth2AuthzSession's in the system

onBind

public android.os.IBinder onBind(android.content.Intent intent)

Specified by:

onBind in class android.app.Service

onUnbind

public boolean onUnbind(android.content.Intent intent)

Overrides:

onUnbind in class android.app.Service

getHttpProvider

protected org.jboss.aerogear.android.http.HttpProvider getHttpProvider(URL url)

This method allows an implementation to change how the HttpProvider is fetched. Override is mostly used for testing.

Parameters:

url - the url endpoint

Returns:

a httpProvider

removeAccount

public void removeAccount(String accountId)

Removes the account with the provided ID

Parameters:

accountId -