Package com.arubanetworks.meridian.triggers

Class TriggersService

java.lang.Object

android.content.Context

android.content.ContextWrapper

android.app.Service

android.app.IntentService

com.arubanetworks.meridian.triggers.TriggersService

All Implemented Interfaces:

ComponentCallbacks, ComponentCallbacks2

public class TriggersService
extends IntentService

A background service for listening to Meridian triggers.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	TriggersService.RegisterTriggersJobAgainEvent	Internal class used by the triggers jobScheduler.
static class	TriggersService.TriggerSubscription	Subscription that can be used in conjunction with Triggers to be informed when a device is in range of Meridian proximity beacons

Nested classes/interfaces inherited from class android.content.Context

Context.BindServiceFlags

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, STOP_FOREGROUND_DETACH, STOP_FOREGROUND_LEGACY, STOP_FOREGROUND_REMOVE

Fields inherited from class android.content.Context

ACCESSIBILITY_SERVICE, ACCOUNT_SERVICE, ACTIVITY_SERVICE, ALARM_SERVICE, APP_OPS_SERVICE, APP_SEARCH_SERVICE, APPWIDGET_SERVICE, AUDIO_SERVICE, BATTERY_SERVICE, BIND_ABOVE_CLIENT, BIND_ADJUST_WITH_ACTIVITY, BIND_ALLOW_ACTIVITY_STARTS, BIND_ALLOW_OOM_MANAGEMENT, BIND_AUTO_CREATE, BIND_DEBUG_UNBIND, BIND_EXTERNAL_SERVICE, BIND_EXTERNAL_SERVICE_LONG, BIND_IMPORTANT, BIND_INCLUDE_CAPABILITIES, BIND_NOT_FOREGROUND, BIND_NOT_PERCEPTIBLE, BIND_PACKAGE_ISOLATED_PROCESS, BIND_SHARED_ISOLATED_PROCESS, BIND_WAIVE_PRIORITY, BIOMETRIC_SERVICE, BLOB_STORE_SERVICE, BLUETOOTH_SERVICE, BUGREPORT_SERVICE, CAMERA_SERVICE, CAPTIONING_SERVICE, CARRIER_CONFIG_SERVICE, CLIPBOARD_SERVICE, COMPANION_DEVICE_SERVICE, CONNECTIVITY_DIAGNOSTICS_SERVICE, CONNECTIVITY_SERVICE, CONSUMER_IR_SERVICE, CONTACT_KEYS_SERVICE, CONTEXT_IGNORE_SECURITY, CONTEXT_INCLUDE_CODE, CONTEXT_RESTRICTED, CREDENTIAL_SERVICE, CROSS_PROFILE_APPS_SERVICE, DEVICE_ID_DEFAULT, DEVICE_ID_INVALID, DEVICE_LOCK_SERVICE, DEVICE_POLICY_SERVICE, DISPLAY_HASH_SERVICE, DISPLAY_SERVICE, DOMAIN_VERIFICATION_SERVICE, DOWNLOAD_SERVICE, DROPBOX_SERVICE, EUICC_SERVICE, FILE_INTEGRITY_SERVICE, FINGERPRINT_SERVICE, GAME_SERVICE, GRAMMATICAL_INFLECTION_SERVICE, HARDWARE_PROPERTIES_SERVICE, HEALTHCONNECT_SERVICE, INPUT_METHOD_SERVICE, INPUT_SERVICE, IPSEC_SERVICE, JOB_SCHEDULER_SERVICE, KEYGUARD_SERVICE, LAUNCHER_APPS_SERVICE, LAYOUT_INFLATER_SERVICE, LOCALE_SERVICE, LOCATION_SERVICE, MEDIA_COMMUNICATION_SERVICE, MEDIA_METRICS_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, OVERLAY_SERVICE, PEOPLE_SERVICE, PERFORMANCE_HINT_SERVICE, PERSISTENT_DATA_BLOCK_SERVICE, POWER_SERVICE, PRINT_SERVICE, PROFILING_SERVICE, RECEIVER_EXPORTED, RECEIVER_NOT_EXPORTED, RECEIVER_VISIBLE_TO_INSTANT_APPS, RESTRICTIONS_SERVICE, ROLE_SERVICE, SEARCH_SERVICE, SECURITY_STATE_SERVICE, SENSOR_SERVICE, SHORTCUT_SERVICE, STATUS_BAR_SERVICE, STORAGE_SERVICE, STORAGE_STATS_SERVICE, SYSTEM_HEALTH_SERVICE, TELECOM_SERVICE, TELEPHONY_IMS_SERVICE, TELEPHONY_SERVICE, TELEPHONY_SUBSCRIPTION_SERVICE, TEXT_CLASSIFICATION_SERVICE, TEXT_SERVICES_MANAGER_SERVICE, TV_INPUT_SERVICE, TV_INTERACTIVE_APP_SERVICE, UI_MODE_SERVICE, USAGE_STATS_SERVICE, USB_SERVICE, USER_SERVICE, VIBRATOR_MANAGER_SERVICE, VIBRATOR_SERVICE, VIRTUAL_DEVICE_SERVICE, VPN_MANAGEMENT_SERVICE, WALLPAPER_SERVICE, WIFI_AWARE_SERVICE, WIFI_P2P_SERVICE, WIFI_RTT_RANGING_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	Description
TriggersService()	Constructs the default TriggersService.

Method Summary

Modifier and Type	Method	Description
protected static void	jobFinished(Context context, EditorKey appKey)	Internal function used by the triggers jobScheduler.
protected void	onHandleIntent(Intent intent)
void	onRegisterTriggersJobAgainEvent(TriggersService.RegisterTriggersJobAgainEvent event)	Internal function used by the triggers jobScheduler.
static void	resetAllTriggers(Context context)	Resets triggers cool downs.
static void	startMonitoring(Context context, EditorKey appKey, ArrayList<TriggersService.TriggerSubscription> subscriptions)	Starts monitoring for new trigger events, if you intend to handle trigger notifications this method should be called either in an on boot handler or each time your application starts.
static void	stopMonitoring(Context context)	Stops monitoring for Trigger notifications.
static void	subscribe(Context context, EditorKey appKey, ArrayList<TriggersService.TriggerSubscription> subscriptions)	Add additional TriggersService.TriggerSubscription to the list of subscriptions being monitored.
static void	unsubscribe(Context context, EditorKey appKey, ArrayList<String> subscriptionNames)	Remove subscriptions by name from active monitoring.

Methods inherited from class android.app.IntentService

onBind, onCreate, onDestroy, onStart, onStartCommand, setIntentRedelivery

Methods inherited from class android.app.Service

attachBaseContext, dump, getApplication, getForegroundServiceType, onConfigurationChanged, onLowMemory, onRebind, onTaskRemoved, onTimeout, onTimeout, onTrimMemory, onUnbind, startForeground, startForeground, stopForeground, stopForeground, stopSelf, stopSelf, stopSelfResult

Methods inherited from class android.content.ContextWrapper

bindIsolatedService, bindService, bindService, bindService, bindService, bindServiceAsUser, bindServiceAsUser, checkCallingOrSelfPermission, checkCallingOrSelfUriPermission, checkCallingOrSelfUriPermissions, checkCallingPermission, checkCallingUriPermission, checkCallingUriPermissions, checkContentUriPermissionFull, checkPermission, checkSelfPermission, checkUriPermission, checkUriPermission, checkUriPermissions, clearWallpaper, createAttributionContext, createConfigurationContext, createContext, createContextForSplit, createDeviceContext, createDeviceProtectedStorageContext, createDisplayContext, createPackageContext, createWindowContext, createWindowContext, databaseList, deleteDatabase, deleteFile, deleteSharedPreferences, enforceCallingOrSelfPermission, enforceCallingOrSelfUriPermission, enforceCallingPermission, enforceCallingUriPermission, enforcePermission, enforceUriPermission, enforceUriPermission, fileList, getApplicationContext, getApplicationInfo, getAssets, getAttributionSource, getAttributionTag, getBaseContext, getCacheDir, getClassLoader, getCodeCacheDir, getContentResolver, getDatabasePath, getDataDir, getDeviceId, getDir, getDisplay, getExternalCacheDir, getExternalCacheDirs, getExternalFilesDir, getExternalFilesDirs, getExternalMediaDirs, getFilesDir, getFileStreamPath, getMainExecutor, getMainLooper, getNoBackupFilesDir, getObbDir, getObbDirs, getOpPackageName, getPackageCodePath, getPackageManager, getPackageName, getPackageResourcePath, getParams, getResources, getSharedPreferences, getSystemService, getSystemServiceName, getTheme, getWallpaper, getWallpaperDesiredMinimumHeight, getWallpaperDesiredMinimumWidth, grantUriPermission, isDeviceProtectedStorage, isRestricted, isUiContext, moveDatabaseFrom, moveSharedPreferencesFrom, openFileInput, openFileOutput, openOrCreateDatabase, openOrCreateDatabase, peekWallpaper, registerComponentCallbacks, registerDeviceIdChangeListener, registerReceiver, registerReceiver, registerReceiver, registerReceiver, removeStickyBroadcast, removeStickyBroadcastAsUser, revokeSelfPermissionsOnKill, revokeUriPermission, revokeUriPermission, sendBroadcast, sendBroadcast, sendBroadcast, sendBroadcastAsUser, sendBroadcastAsUser, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcast, sendOrderedBroadcastAsUser, sendStickyBroadcast, sendStickyBroadcast, sendStickyBroadcastAsUser, sendStickyOrderedBroadcast, sendStickyOrderedBroadcastAsUser, setTheme, setWallpaper, setWallpaper, startActivities, startActivities, startActivity, startActivity, startForegroundService, startInstrumentation, startIntentSender, startIntentSender, startService, stopService, unbindService, unregisterComponentCallbacks, unregisterDeviceIdChangeListener, unregisterReceiver, updateServiceGroup

Methods inherited from class android.content.Context

bindIsolatedService, getColor, getColorStateList, getDrawable, getString, getString, getSystemService, getText, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, obtainStyledAttributes, revokeSelfPermissionOnKill, sendBroadcastWithMultiplePermissions

Methods inherited from class java.lang.Object

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

Constructor Details

TriggersService

public TriggersService()

Constructs the default TriggersService.

Method Details

startMonitoring

public static void startMonitoring(@NonNull
 Context context,
 @NonNull
 EditorKey appKey,
 ArrayList<TriggersService.TriggerSubscription> subscriptions)

Starts monitoring for new trigger events, if you intend to handle trigger notifications this method should be called either in an on boot handler or each time your application starts.<p>The trigger response is in your local TriggersBroadcastReceiver that is registered in the manifest.</p>

Parameters:

context - <ul> <li>the context to use, preferably the application context</li> </ul>

appKey - <ul> <li>the application key for your application</li> </ul>

subscriptions - <ul> <li>the subscriptions listing the proximity beacons to listened for</li> </ul>

stopMonitoring

public static void stopMonitoring(@NonNull
 Context context)

Stops monitoring for Trigger notifications.

resetAllTriggers

public static void resetAllTriggers(@NonNull
 Context context)

Resets triggers cool downs.<p>Note that it takes about 20 seconds for the reset to occur.</p>

subscribe

public static void subscribe(@NonNull
 Context context,
 @NonNull
 EditorKey appKey,
 ArrayList<TriggersService.TriggerSubscription> subscriptions)

Add additional TriggersService.TriggerSubscription to the list of subscriptions being monitored.<p>Note that it takes up to 20 seconds for new subscription to start If triggers has not been been started, this will call startMonitoring</p>

Parameters:

context - <ul> <li>the context to use, preferably the application context</li> </ul>

appKey - <ul> <li>the application key for your application</li> </ul>

subscriptions - <ul> <li>additions subscriptions to listened for</li> </ul>

unsubscribe

public static void unsubscribe(@NonNull
 Context context,
 @NonNull
 EditorKey appKey,
 ArrayList<String> subscriptionNames)

Remove subscriptions by name from active monitoring.<p>Note that it takes up to 20 seconds for subscriptions to be removed.</p>

Parameters:

context - <ul> <li>the context to use, preferably the application context</li> </ul>

appKey - <ul> <li>the application key for your application</li> </ul>

subscriptionNames - <ul> <li>subscriptions to be removed</li> </ul>

onHandleIntent

protected void onHandleIntent(Intent intent)

Specified by:

onHandleIntent in class IntentService

onRegisterTriggersJobAgainEvent

public void onRegisterTriggersJobAgainEvent(TriggersService.RegisterTriggersJobAgainEvent event)

Internal function used by the triggers jobScheduler.<p>For internal use only</p>

jobFinished

protected static void jobFinished(@NonNull
 Context context,
 @NonNull
 EditorKey appKey)

Internal function used by the triggers jobScheduler.<p>For internal use only</p>