universum.studios.android.universi

Class UniversiActivity

java.lang.Object

android.content.Context

android.content.ContextWrapper

android.view.ContextThemeWrapper

android.app.Activity

universum.studios.android.universi.UniversiActivity

All Implemented Interfaces:

ComponentCallbacks, ComponentCallbacks2, KeyEvent.Callback, LayoutInflater.Factory, LayoutInflater.Factory2, View.OnCreateContextMenuListener, Window.Callback, UniversiActivityContext

public abstract class UniversiActivity
extends Activity
implements UniversiActivityContext

An Activity implementation that provides Universi context features via UniversiActivityDelegate including other features described below.

1) Data binding

Whether it is used data binding provided by Google to bind application logic and layouts or some custom data binding logic, this activity class provides a simple way to manage data binding requests and to perform actual binding. Whether a new data need to be bound to a view hierarchy of a specific instance of UniversiActivity, requestBindData() need to be called. This method can be invoked from any thread. If data binding request has been registered, UniversiActivity will invoke onBindData() method whenever its view hierarchy is already created or waits until it is created.

1) Permissions

This activity class has support for a new permissions management model introduced in the Marshmallow Android version. Permissions related methods like checkSelfPermission(String) or supportRequestPermissions(String[], int) can be invoked regardless of current Android version.

Author:

Martin Albedinsky

See Also:

UniversiCompatActivity, UniversiFragment

Field Summary

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, ACCOUNT_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, APP_OPS_SERVICE, APPWIDGET_SERVICE, AUDIO_SERVICE, BATTERY_SERVICE, BIND_ABOVE_CLIENT, BIND_ADJUST_WITH_ACTIVITY, BIND_ALLOW_OOM_MANAGEMENT, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BIND_EXTERNAL_SERVICE, BIND_IMPORTANT, BIND_NOT_FOREGROUND, BIND_WAIVE_PRIORITY, BLUETOOTH_SERVICE, CAMERA_SERVICE, CAPTIONING_SERVICE, CARRIER_CONFIG_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, FINGERPRINT_SERVICE, HARDWARE_PROPERTIES_SERVICE, INPUT_METHOD_SERVICE, INPUT_SERVICE, JOB_SCHEDULER_SERVICE, KEYGUARD_SERVICE, LAUNCHER_APPS_SERVICE, LAYOUT_INFLATER_SERVICE, LOCATION_SERVICE, MEDIA_PROJECTION_SERVICE, MEDIA_ROUTER_SERVICE, MEDIA_SESSION_SERVICE, MIDI_SERVICE, MODE_APPEND, MODE_ENABLE_WRITE_AHEAD_LOGGING, MODE_MULTI_PROCESS, MODE_NO_LOCALIZED_COLLATORS, MODE_PRIVATE, MODE_WORLD_READABLE, MODE_WORLD_WRITEABLE, NETWORK_STATS_SERVICE, NFC_SERVICE, NOTIFICATION_SERVICE, NSD_SERVICE, POWER_SERVICE, PRINT_SERVICE, RESTRICTIONS_SERVICE, SEARCH_SERVICE, SENSOR_SERVICE, SHORTCUT_SERVICE, STORAGE_SERVICE, SYSTEM_HEALTH_SERVICE, TELECOM_SERVICE, TELEPHONY_SERVICE, TELEPHONY_SUBSCRIPTION_SERVICE, TEXT_SERVICES_MANAGER_SERVICE, TV_INPUT_SERVICE, UI_MODE_SERVICE, USAGE_STATS_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
UniversiActivity() Creates a new instance of UniversiActivity.

Method Summary

Modifier and Type	Method and Description
int	checkSelfPermission(String permission)
void	destroyLoader(int id) Destroys a loader with the specified id.
boolean	dismissDialogWithId(int dialogId) Dismisses a dialog that is provided by the current dialog factory under the specified dialogId.
boolean	dismissXmlDialog(int resId) Dismisses an Xml dialog that has been shown via UniversiActivityContext.showXmlDialog(int, DialogOptions).
protected boolean	dispatchBackPressToCurrentFragment() Dispatches back press event to the current fragment displayed in context of this activity.
protected boolean	dispatchBackPressToFragments() Dispatches back press event to all currently visible fragments displayed in context of this activity.
protected Fragment	findCurrentFragment() Finds currently visible fragment that is displayed in context of this activity.
boolean	finishWithNavigationalTransition() Finishes this activity with navigational transition specified via UniversiActivityContext.setNavigationalTransition(BaseNavigationalTransition) (if any).
protected universum.studios.android.fragment.annotation.handler.ActionBarFragmentAnnotationHandler	getAnnotationHandler() Returns handler that is responsible for annotations processing of this class and also for handling all annotations related operations for this class.
universum.studios.android.dialog.manage.DialogController	getDialogController() Returns the controller that can be used to show and dismiss dialogs within context of this activity.
universum.studios.android.dialog.manage.DialogFactory	getDialogFactory() Returns the current dialog factory specified for this activity.
FragmentController	getFragmentController() Returns the controller that can be used to show and hide fragments within context of this activity.
FragmentFactory	getFragmentFactory() Returns the current fragment factory specified for this activity.
universum.studios.android.transition.BaseNavigationalTransition	getNavigationalTransition() Returns the navigational transition that will be used to finish this activity.
<D> Loader<D>	initLoader(int id, Bundle params, LoaderManager.LoaderCallbacks<D> callbacks) Initializes a loader with the specified id for the given callbacks.
boolean	isActiveNetworkConnected() Checks whether the current active network is at this time connected or not.
boolean	isNetworkConnected(int networkType) Checks whether a network with the specified networkType is at this time connected or no.
protected boolean	onBackPress() Invoked from onBackPressed() to give a chance to this activity instance to consume the back press event before it is delivered to its parent.
void	onBackPressed()
protected void	onBindData() Invoked due to call to requestBindData() to perform data binding specific for this activity instance.
protected void	onBindViews() Invoked from onContentChanged() to bind all views presented within context of this activity.
void	onContentChanged()
protected void	onCreate(Bundle savedInstanceState)
boolean	onCreateOptionsMenu(Menu menu)
protected void	onPause()
void	onRequestPermissionsResult(int requestCode, String[] permissions, int[] grantResults)
protected void	onResume()
protected boolean	popFragmentsBackStack() Pops stack with fragments of this activity.
protected void	requestBindData() Requests performing of data binding specific for this activity via onBindData().
<D> Loader<D>	restartLoader(int id, Bundle params, LoaderManager.LoaderCallbacks<D> callbacks) Re-starts a loader with the specified id for the given callbacks.
void	setActionBar(Toolbar toolbar)
void	setDialogController(universum.studios.android.dialog.manage.DialogController controller) Sets a controller that should be used to show and dismiss dialogs within context of this activity.
void	setDialogFactory(universum.studios.android.dialog.manage.DialogFactory factory) Specifies a factory that provides dialog instances for DialogController of this activity.
void	setDialogXmlFactory(int xmlDialogsSet) Specifies a factory that should provide dialog instances that can be parsed from an Xml file with the specified xmlDialogsSet for DialogController of this activity.
void	setFragmentController(FragmentController controller) Sets a controller that should be used to show and hide fragments within context of this activity.
void	setFragmentFactory(FragmentFactory factory) Specifies a factory that provides fragment instances for FragmentController of his activity.
void	setNavigationalTransition(universum.studios.android.transition.BaseNavigationalTransition transition) Sets a navigational transition that will be used to finish this activity context whenever its Activity.finishAfterTransition() is invoked.
boolean	shouldShowRequestPermissionRationale(String permission)
boolean	showDialogWithId(int dialogId) Same as UniversiActivityContext.showDialogWithId(int, DialogOptions) with null options.
boolean	showDialogWithId(int dialogId, universum.studios.android.dialog.DialogOptions options) Shows a dialog that is provided by the current dialog factory under the specified dialogId.
boolean	showXmlDialog(int resId) Same as UniversiActivityContext.showXmlDialog(int, DialogOptions) with null options.
boolean	showXmlDialog(int resId, universum.studios.android.dialog.DialogOptions options) Like UniversiActivityContext.showDialogWithId(int, DialogOptions), but in this case will be used internal instance of DialogXmlFactory to create (inflate) the desired dialog instance to be shown.
<D> Loader<D>	startLoader(int id, Bundle params, LoaderManager.LoaderCallbacks<D> callbacks) Starts a loader with the specified id.
void	supportRequestPermissions(String[] permissions, int requestCode) Invokes Activity.requestPermissions(String[], int) on Android versions above Marshmallow (including).

Methods inherited from class android.app.Activity

addContentView, closeContextMenu, closeOptionsMenu, createPendingResult, dismissDialog, dismissKeyboardShortcutsHelper, dispatchGenericMotionEvent, dispatchKeyEvent, dispatchKeyShortcutEvent, dispatchPopulateAccessibilityEvent, dispatchTouchEvent, dispatchTrackballEvent, dump, enterPictureInPictureMode, findViewById, finish, finishActivity, finishActivityFromChild, finishAffinity, finishAfterTransition, finishAndRemoveTask, finishFromChild, getActionBar, getApplication, getCallingActivity, getCallingPackage, getChangingConfigurations, getComponentName, getContentScene, getContentTransitionManager, getCurrentFocus, getFragmentManager, getIntent, getLastNonConfigurationInstance, getLayoutInflater, getLoaderManager, getLocalClassName, getMediaController, getMenuInflater, getParent, getParentActivityIntent, getPreferences, getReferrer, getRequestedOrientation, getSearchEvent, getSystemService, getTaskId, getTitle, getTitleColor, getVoiceInteractor, getVolumeControlStream, getWindow, getWindowManager, hasWindowFocus, invalidateOptionsMenu, isChangingConfigurations, isChild, isDestroyed, isFinishing, isImmersive, isInMultiWindowMode, isInPictureInPictureMode, isLocalVoiceInteractionSupported, isTaskRoot, isVoiceInteraction, isVoiceInteractionRoot, managedQuery, moveTaskToBack, navigateUpTo, navigateUpToFromChild, onActionModeFinished, onActionModeStarted, onActivityReenter, onActivityResult, onApplyThemeResource, onAttachedToWindow, onAttachFragment, onChildTitleChanged, onConfigurationChanged, onContextItemSelected, onContextMenuClosed, onCreate, onCreateContextMenu, onCreateDescription, onCreateDialog, onCreateDialog, onCreateNavigateUpTaskStack, onCreatePanelMenu, onCreatePanelView, onCreateThumbnail, onCreateView, onCreateView, onDestroy, onDetachedFromWindow, onEnterAnimationComplete, onGenericMotionEvent, onKeyDown, onKeyLongPress, onKeyMultiple, onKeyShortcut, onKeyUp, onLocalVoiceInteractionStarted, onLocalVoiceInteractionStopped, onLowMemory, onMenuItemSelected, onMenuOpened, onMultiWindowModeChanged, onNavigateUp, onNavigateUpFromChild, onNewIntent, onOptionsItemSelected, onOptionsMenuClosed, onPanelClosed, onPictureInPictureModeChanged, onPostCreate, onPostCreate, onPostResume, onPrepareDialog, onPrepareDialog, onPrepareNavigateUpTaskStack, onPrepareOptionsMenu, onPreparePanel, onProvideAssistContent, onProvideAssistData, onProvideKeyboardShortcuts, onProvideReferrer, onRestart, onRestoreInstanceState, onRestoreInstanceState, onRetainNonConfigurationInstance, onSaveInstanceState, onSaveInstanceState, onSearchRequested, onSearchRequested, onStart, onStateNotSaved, onStop, onTitleChanged, onTouchEvent, onTrackballEvent, onTrimMemory, onUserInteraction, onUserLeaveHint, onVisibleBehindCanceled, onWindowAttributesChanged, onWindowFocusChanged, onWindowStartingActionMode, onWindowStartingActionMode, openContextMenu, openOptionsMenu, overridePendingTransition, postponeEnterTransition, recreate, registerForContextMenu, releaseInstance, removeDialog, reportFullyDrawn, requestDragAndDropPermissions, requestPermissions, requestShowKeyboardShortcuts, requestVisibleBehind, requestWindowFeature, runOnUiThread, setContentTransitionManager, setContentView, setContentView, setContentView, setDefaultKeyMode, setEnterSharedElementCallback, setExitSharedElementCallback, setFeatureDrawable, setFeatureDrawableAlpha, setFeatureDrawableResource, setFeatureDrawableUri, setFinishOnTouchOutside, setImmersive, setIntent, setMediaController, setProgress, setProgressBarIndeterminate, setProgressBarIndeterminateVisibility, setProgressBarVisibility, setRequestedOrientation, setResult, setResult, setSecondaryProgress, setTaskDescription, setTheme, setTitle, setTitle, setTitleColor, setVisible, setVolumeControlStream, setVrModeEnabled, shouldUpRecreateTask, showAssist, showDialog, showDialog, showLockTaskEscapeMessage, startActionMode, startActionMode, startActivities, startActivities, startActivity, startActivity, startActivityForResult, startActivityForResult, startActivityFromChild, startActivityFromChild, startActivityFromFragment, startActivityFromFragment, startActivityIfNeeded, startActivityIfNeeded, startIntentSender, startIntentSender, startIntentSenderForResult, startIntentSenderForResult, startIntentSenderFromChild, startIntentSenderFromChild, startLocalVoiceInteraction, startLockTask, startManagingCursor, startNextMatchingActivity, startNextMatchingActivity, startPostponedEnterTransition, startSearch, stopLocalVoiceInteraction, stopLockTask, stopManagingCursor, takeKeyEvents, triggerSearch, unregisterForContextMenu

Methods inherited from class android.view.ContextThemeWrapper

applyOverrideConfiguration, attachBaseContext, getAssets, getResources, getTheme

Methods inherited from class android.content.ContextWrapper

bindService, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingPermission, checkCallingUriPermission, checkPermission, checkUriPermission, checkUriPermission, clearWallpaper, createConfigurationContext, createDeviceProtectedStorageContext, createDisplayContext, createPackageContext, databaseList, deleteDatabase, deleteFile, deleteSharedPreferences, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getBaseContext, getCacheDir, getClassLoader, getCodeCacheDir, getContentResolver, getDatabasePath, getDataDir, getDir, getExternalCacheDir, getExternalCacheDirs, getExternalFilesDir, getExternalFilesDirs, getExternalMediaDirs, getFilesDir, getFileStreamPath, getMainLooper, getNoBackupFilesDir, getObbDir, getObbDirs, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getSharedPreferences, getSystemServiceName, getWallpaper, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, grantUriPermission, isDeviceProtectedStorage, isRestricted, moveDatabaseFrom, moveSharedPreferencesFrom, openFileInput, openFileOutput, openOrCreateDatabase, openOrCreateDatabase, peekWallpaper, registerReceiver, registerReceiver, removeStickyBroadcast, removeStickyBroadcastAsUser, revokeUriPermission, sendBroadcast, sendBroadcast, sendBroadcastAsUser, sendBroadcastAsUser, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcastAsUser, sendStickyBroadcast, sendStickyBroadcastAsUser, sendStickyOrderedBroadcast, sendStickyOrderedBroadcastAsUser, setWallpaper, setWallpaper, startInstrumentation, startService, stopService, unbindService, unregisterReceiver

Methods inherited from class android.content.Context

getColor, getColorStateList, getDrawable, getString, getString, getSystemService, 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

UniversiActivity

public UniversiActivity()

Creates a new instance of UniversiActivity. If annotations processing is enabled via FragmentsConfig.ANNOTATIONS_PROCESSING_ENABLED all annotations supported by this activity class will be processed/obtained here so they can be later used.

Method Detail

getAnnotationHandler

@NonNull
protected universum.studios.android.fragment.annotation.handler.ActionBarFragmentAnnotationHandler getAnnotationHandler()

Returns handler that is responsible for annotations processing of this class and also for handling all annotations related operations for this class.

Returns:

Annotations handler specific for this class.

Throws:

IllegalStateException - If annotations processing is not enabled for the Fragments library.

onCreate

protected void onCreate(@Nullable
                        Bundle savedInstanceState)

Overrides:

onCreate in class Activity

startLoader

@Nullable
public <D> Loader<D> startLoader(int id,
                                            @Nullable
                                            Bundle params,
                                            @NonNull
                                            LoaderManager.LoaderCallbacks<D> callbacks)

Description copied from interface: UniversiActivityContext

Starts a loader with the specified id. If there was already started loader with the same id before, such a loader will be re-started, otherwise new loader will be initialized.

Specified by:

startLoader in interface UniversiActivityContext

Parameters:

id - Id of the desired loader to start.

params - Params for loader.

callbacks - Callbacks for loader.

Returns:

Initialized or re-started loader instance or null if the specified callbacks do not create loader for the specified id.

See Also:

UniversiActivityContext.initLoader(int, Bundle, LoaderManager.LoaderCallbacks), UniversiActivityContext.restartLoader(int, Bundle, LoaderManager.LoaderCallbacks), UniversiActivityContext.destroyLoader(int)

initLoader

@Nullable
public <D> Loader<D> initLoader(int id,
                                           @Nullable
                                           Bundle params,
                                           @NonNull
                                           LoaderManager.LoaderCallbacks<D> callbacks)

Description copied from interface: UniversiActivityContext

Initializes a loader with the specified id for the given callbacks.

Specified by:

initLoader in interface UniversiActivityContext

Parameters:

id - Id of the desired loader to init.

params - Params for loader.

callbacks - Callbacks for loader.

Returns:

Initialized loader instance or null if the specified callbacks do not create loader for the specified id.

See Also:

UniversiActivityContext.startLoader(int, Bundle, LoaderManager.LoaderCallbacks), UniversiActivityContext.restartLoader(int, Bundle, LoaderManager.LoaderCallbacks), UniversiActivityContext.destroyLoader(int), LoaderManager.initLoader(int, Bundle, LoaderManager.LoaderCallbacks)

restartLoader

@Nullable
public <D> Loader<D> restartLoader(int id,
                                              @Nullable
                                              Bundle params,
                                              @NonNull
                                              LoaderManager.LoaderCallbacks<D> callbacks)

Description copied from interface: UniversiActivityContext

Re-starts a loader with the specified id for the given callbacks.

Specified by:

restartLoader in interface UniversiActivityContext

Parameters:

id - Id of the desired loader to re-start.

params - Params for loader.

callbacks - Callbacks for loader.

Returns:

Re-started loader instance or null if the specified callbacks do not create loader for the specified id.

See Also:

UniversiActivityContext.startLoader(int, Bundle, LoaderManager.LoaderCallbacks), UniversiActivityContext.initLoader(int, Bundle, LoaderManager.LoaderCallbacks), UniversiActivityContext.destroyLoader(int), LoaderManager.restartLoader(int, Bundle, LoaderManager.LoaderCallbacks)

destroyLoader

public void destroyLoader(int id)

Description copied from interface: UniversiActivityContext

Destroys a loader with the specified id.

Specified by:

destroyLoader in interface UniversiActivityContext

Parameters:

id - Id of the desired loader to destroy.

See Also:

UniversiActivityContext.initLoader(int, Bundle, LoaderManager.LoaderCallbacks), UniversiActivityContext.restartLoader(int, Bundle, LoaderManager.LoaderCallbacks), LoaderManager.destroyLoader(int)

onContentChanged

public void onContentChanged()

Specified by:

onContentChanged in interface Window.Callback

Overrides:

onContentChanged in class Activity

setActionBar

public void setActionBar(@Nullable
                         Toolbar toolbar)

Overrides:

setActionBar in class Activity

onBindViews

protected void onBindViews()

Invoked from onContentChanged() to bind all views presented within context of this activity.

onCreateOptionsMenu

public boolean onCreateOptionsMenu(@NonNull
                                   Menu menu)

Overrides:

onCreateOptionsMenu in class Activity

setNavigationalTransition

public void setNavigationalTransition(@Nullable
                                      universum.studios.android.transition.BaseNavigationalTransition transition)

Description copied from interface: UniversiActivityContext

Sets a navigational transition that will be used to finish this activity context whenever its Activity.finishAfterTransition() is invoked.

If the given transition is not null this method will also configure incoming transitions for this activity via BaseNavigationalTransition.configureIncomingTransitions(Activity).

Specified by:

setNavigationalTransition in interface UniversiActivityContext

Parameters:

transition - The desired transition. May be null to clear the current one.

See Also:

UniversiActivityContext.getNavigationalTransition()

getNavigationalTransition

@Nullable
public universum.studios.android.transition.BaseNavigationalTransition getNavigationalTransition()

Description copied from interface: UniversiActivityContext

Returns the navigational transition that will be used to finish this activity.

Specified by:

getNavigationalTransition in interface UniversiActivityContext

Returns:

Transition or null if no transition has been specified.

See Also:

UniversiActivityContext.setNavigationalTransition(BaseNavigationalTransition)

getFragmentController

@NonNull
public FragmentController getFragmentController()

Description copied from interface: UniversiActivityContext

Returns the controller that can be used to show and hide fragments within context of this activity.

If not specified, instance of FragmentController is instantiated by default.

Specified by:

getFragmentController in interface UniversiActivityContext

Returns:

The fragment controller of this activity.

See Also:

UniversiActivityContext.setFragmentController(FragmentController)

setFragmentController

public void setFragmentController(@Nullable
                                  FragmentController controller)

Description copied from interface: UniversiActivityContext

Sets a controller that should be used to show and hide fragments within context of this activity.

Specified by:

setFragmentController in interface UniversiActivityContext

Parameters:

controller - The desired controller. May be null to use the default one.

See Also:

UniversiActivityContext.getFragmentController(), UniversiActivityContext.setFragmentFactory(FragmentFactory)

setFragmentFactory

public void setFragmentFactory(@Nullable
                               FragmentFactory factory)

Description copied from interface: UniversiActivityContext

Specifies a factory that provides fragment instances for FragmentController of his activity.

Specified by:

setFragmentFactory in interface UniversiActivityContext

Parameters:

factory - The desired factory. May be null to remove the current one.

See Also:

UniversiActivityContext.getFragmentFactory(), UniversiActivityContext.setFragmentController(FragmentController), UniversiActivityContext.getFragmentController()

getFragmentFactory

@Nullable
public FragmentFactory getFragmentFactory()

Description copied from interface: UniversiActivityContext

Returns the current fragment factory specified for this activity.

Specified by:

getFragmentFactory in interface UniversiActivityContext

Returns:

Fragment factory or null if no factory has been specified yet.

See Also:

UniversiActivityContext.setFragmentFactory(FragmentFactory)

setDialogController

public void setDialogController(@Nullable
                                universum.studios.android.dialog.manage.DialogController controller)

Description copied from interface: UniversiActivityContext

Sets a controller that should be used to show and dismiss dialogs within context of this activity.

Specified by:

setDialogController in interface UniversiActivityContext

Parameters:

controller - The desired controller. May be null to use the default one.

See Also:

UniversiActivityContext.getDialogController(), UniversiActivityContext.setFragmentFactory(FragmentFactory)

getDialogController

@NonNull
public universum.studios.android.dialog.manage.DialogController getDialogController()

Description copied from interface: UniversiActivityContext

Returns the controller that can be used to show and dismiss dialogs within context of this activity.

If not specified, instance of DialogController is instantiated by default.

Specified by:

getDialogController in interface UniversiActivityContext

Returns:

The dialog controller of this activity.

See Also:

UniversiActivityContext.setDialogController(DialogController)

setDialogXmlFactory

public void setDialogXmlFactory(@XmlRes
                                int xmlDialogsSet)

Description copied from interface: UniversiActivityContext

Specifies a factory that should provide dialog instances that can be parsed from an Xml file with the specified xmlDialogsSet for DialogController of this activity.

Specified by:

setDialogXmlFactory in interface UniversiActivityContext

Parameters:

xmlDialogsSet - Resource id of the desired Xml file containing Xml dialogs that the factory should provide for this activity. May be 0 to remove the current one.

See Also:

UniversiActivityContext.setDialogFactory(DialogFactory)

setDialogFactory

public void setDialogFactory(@Nullable
                             universum.studios.android.dialog.manage.DialogFactory factory)

Description copied from interface: UniversiActivityContext

Specifies a factory that provides dialog instances for DialogController of this activity.

Specified by:

setDialogFactory in interface UniversiActivityContext

Parameters:

factory - The desired factory. May be null to remove the current one.

See Also:

UniversiActivityContext.getDialogFactory(), UniversiActivityContext.showDialogWithId(int), UniversiActivityContext.showDialogWithId(int, DialogOptions)

getDialogFactory

@Nullable
public universum.studios.android.dialog.manage.DialogFactory getDialogFactory()

Description copied from interface: UniversiActivityContext

Returns the current dialog factory specified for this activity.

Specified by:

getDialogFactory in interface UniversiActivityContext

Returns:

Dialog factory or null if no factory has been specified yet.

See Also:

UniversiActivityContext.setDialogFactory(DialogFactory)

requestBindData

protected void requestBindData()

Requests performing of data binding specific for this activity via onBindData(). If this activity has its view hierarchy already created onBindData() will be invoked immediately, otherwise will wait until onContentChanged() is invoked.

This method may be invoked also from a background-thread.

onBindData

@UiThread
protected void onBindData()

Invoked due to call to requestBindData() to perform data binding specific for this activity instance.

This is always invoked on the UI thread.

onResume

protected void onResume()

Overrides:

onResume in class Activity

isActiveNetworkConnected

public boolean isActiveNetworkConnected()

Description copied from interface: UniversiActivityContext

Checks whether the current active network is at this time connected or not.

Specified by:

isActiveNetworkConnected in interface UniversiActivityContext

Returns:

True if active network is connected, false otherwise.

See Also:

ConnectivityManager.getActiveNetworkInfo(), NetworkInfo.isConnected(), UniversiActivityContext.isNetworkConnected(int)

isNetworkConnected

public boolean isNetworkConnected(int networkType)

Description copied from interface: UniversiActivityContext

Checks whether a network with the specified networkType is at this time connected or no.

Specified by:

isNetworkConnected in interface UniversiActivityContext

Parameters:

networkType - The desired network type to check for connection.

Returns:

True if the requested network is connected, false otherwise.

See Also:

ConnectivityManager.getNetworkInfo(int), NetworkInfo.isConnected()

checkSelfPermission

public int checkSelfPermission(@NonNull
                               String permission)

Overrides:

checkSelfPermission in class ContextWrapper

shouldShowRequestPermissionRationale

public boolean shouldShowRequestPermissionRationale(@NonNull
                                                    String permission)

Overrides:

shouldShowRequestPermissionRationale in class Activity

supportRequestPermissions

public void supportRequestPermissions(@NonNull
                                      String[] permissions,
                                      int requestCode)

Invokes Activity.requestPermissions(String[], int) on Android versions above Marshmallow (including).

Calling this method on Android versions before MARSHMALLOW will be ignored.

Parameters:

permissions - The desired set of permissions to request.

requestCode - Code to identify this request in onRequestPermissionsResult(int, String[], int[]).

onRequestPermissionsResult

public void onRequestPermissionsResult(int requestCode,
                                       @NonNull
                                       String[] permissions,
                                       @NonNull
                                       int[] grantResults)

Overrides:

onRequestPermissionsResult in class Activity

showDialogWithId

public boolean showDialogWithId(int dialogId)

Description copied from interface: UniversiActivityContext

Same as UniversiActivityContext.showDialogWithId(int, DialogOptions) with null options.

Specified by:

showDialogWithId in interface UniversiActivityContext

showDialogWithId

public boolean showDialogWithId(int dialogId,
                                @Nullable
                                universum.studios.android.dialog.DialogOptions options)

Description copied from interface: UniversiActivityContext

Shows a dialog that is provided by the current dialog factory under the specified dialogId.

Specified by:

showDialogWithId in interface UniversiActivityContext

Parameters:

dialogId - Id of the desired dialog to show.

options - Options for the dialog.

Returns:

True if dialog has been shown, false if this activity is currently paused or does not have its dialog factory specified.

See Also:

DialogController.newRequest(int), UniversiActivityContext.setDialogFactory(DialogFactory), UniversiActivityContext.dismissDialogWithId(int)

dismissDialogWithId

public boolean dismissDialogWithId(int dialogId)

Description copied from interface: UniversiActivityContext

Dismisses a dialog that is provided by the current dialog factory under the specified dialogId.

Specified by:

dismissDialogWithId in interface UniversiActivityContext

Parameters:

dialogId - Id of the desired dialog to dismiss.

Returns:

True if dialog has been dismissed, false if this activity is currently paused or does not have its dialog factory specified.

See Also:

DialogController.newRequest(int), UniversiActivityContext.showDialogWithId(int, DialogOptions)

showXmlDialog

public boolean showXmlDialog(@XmlRes
                             int resId)

Description copied from interface: UniversiActivityContext

Same as UniversiActivityContext.showXmlDialog(int, DialogOptions) with null options.

Specified by:

showXmlDialog in interface UniversiActivityContext

showXmlDialog

public boolean showXmlDialog(@XmlRes
                             int resId,
                             @Nullable
                             universum.studios.android.dialog.DialogOptions options)

Description copied from interface: UniversiActivityContext

Like UniversiActivityContext.showDialogWithId(int, DialogOptions), but in this case will be used internal instance of DialogXmlFactory to create (inflate) the desired dialog instance to be shown.

Specified by:

showXmlDialog in interface UniversiActivityContext

Parameters:

resId - Resource id of Xml file containing the desired dialog (its specification) to show.

options - Options for the dialog.

Returns:

True if dialog has been successfully inflated and shown, false if this activity is currently paused or dialog failed to be inflated.

See Also:

DialogXmlFactory.createDialog(int, DialogOptions), UniversiActivityContext.dismissXmlDialog(int)

dismissXmlDialog

public boolean dismissXmlDialog(@XmlRes
                                int resId)

Description copied from interface: UniversiActivityContext

Dismisses an Xml dialog that has been shown via UniversiActivityContext.showXmlDialog(int, DialogOptions).

Specified by:

dismissXmlDialog in interface UniversiActivityContext

Parameters:

resId - Resource id of Xml file containing the desired dialog (its specification) to dismiss.

Returns:

True if dialog has been dismissed, false if this activity is currently paused.

See Also:

UniversiActivityContext.showXmlDialog(int, DialogOptions)

onBackPressed

public void onBackPressed()

Overrides:

onBackPressed in class Activity

onBackPress

protected boolean onBackPress()

Invoked from onBackPressed() to give a chance to this activity instance to consume the back press event before it is delivered to its parent.

This implementation first tries to dispatch this event to one of its visible fragment via dispatchBackPressToFragments() and if none of the currently visible fragments does not consume the event a stack with fragments will be popped via popFragmentsBackStack().

Returns:

True if the back press event has been consumed here, false otherwise.

dispatchBackPressToFragments

protected boolean dispatchBackPressToFragments()

Dispatches back press event to all currently visible fragments displayed in context of this activity.

This implementation calls dispatchBackPressToCurrentFragment() and returns its result.

Returns:

True if some of the visible fragments has consumed the back press event, false otherwise.

See Also:

BackPressWatcher.dispatchBackPress()

dispatchBackPressToCurrentFragment

protected boolean dispatchBackPressToCurrentFragment()

Dispatches back press event to the current fragment displayed in context of this activity.

Returns:

True if the current fragment has consumed the back press event, false otherwise.

See Also:

findCurrentFragment(), BackPressWatcher.dispatchBackPress()

findCurrentFragment

@Nullable
protected Fragment findCurrentFragment()

Finds currently visible fragment that is displayed in context of this activity.

Note, that implementation of this method assumes that this activity uses FragmentController to display its related fragments and that there may be only one fragment visible at a time, that is in a full screen container.

Returns:

Current fragment of this activity (that is at this time visible), or null if there is no fragment presented within fragment container of this activity at all.

popFragmentsBackStack

protected boolean popFragmentsBackStack()

Pops stack with fragments of this activity.

Returns:

True if there was some fragment popped from the stack, false if there were no fragments to pop from.

onPause

protected void onPause()

Overrides:

onPause in class Activity

finishWithNavigationalTransition

public boolean finishWithNavigationalTransition()

Description copied from interface: UniversiActivityContext

Finishes this activity with navigational transition specified via UniversiActivityContext.setNavigationalTransition(BaseNavigationalTransition) (if any).

Specified by:

finishWithNavigationalTransition in interface UniversiActivityContext

Returns:

True if the transition has been used to finish this activity, false if standard framework method (either Activity.finish() or Activity.finishAfterTransition()), depending on the current API level, has been used.