• BlackBerry Dynamics
  • Runtime library for Android applications
  • 9.2.0.99
GDStateListener Interface Reference

Listener interface for authorization state transitions, and other events dispatched from the BlackBerry Dynamics runtime. More...

Description

Transitions in the BlackBerry Dynamics authorization state can be handled by creating a class that implements this interface. This interface can also be used to handle events dispatched from the BlackBerry Dynamics runtime, for example notifications that application policy settings have changed.

There are two interfaces for receiving notifications of these errors and state changes. See under Authorization State Transition Notification Interfaces in the GDAndroid description for a comparison of the two.

Public Member Functions

void onAuthorized ()
 Callback for authorization granting or unlocking. More...
 
void onLocked ()
 Callback for user interface locking. More...
 
void onWiped ()
 Callback for permanent authorization withdrawal. More...
 
void onUpdateConfig (Map< String, Object > settings)
 Callback for changes to application configuration and other settings from the enterprise. More...
 
void onUpdatePolicy (Map< String, Object > policyValues)
 Callback for changes to application-specific policy settings. More...
 
void onUpdateServices ()
 Callback for changes to services-related configuration. More...
 
void onUpdateEntitlements ()
 Callback for changes to entitlements. More...
 

Member Function Documentation

◆ onAuthorized()

void onAuthorized ( )

This callback will be invoked when:

  • The user has been authorized to access the application and its data, following authorization processing.
  • The user interface of the application was locked and has now been unlocked. See onLocked.

◆ onLocked()

void onLocked ( )

This callback will be invoked when the user interface of the application has been locked, for example:

  • When the application has been locked due to expiry of the idle time out.
  • When a remote lock command has been received from the enterprise management console.
  • When an enterprise policy violation has been detected and the enforcement action is to lock the application.

If the condition that caused locking is cleared, for example if the user stops being idle, then the onAuthorized callback will be invoked.

◆ onWiped()

void onWiped ( )

This callback will be invoked when the authorization of the user has been permanently withdrawn, for example:

  • When the end user's entitlement to the application has been removed by the enterprise administrator.
  • When a remote wipe command has been received from the enterprise management console.
  • When an enterprise policy violation has been detected and the enforcement action is to wipe the application.

This callback notifies the application that the container has been wiped of all application data and authentication credentials. Wiped data cannot be retrieved or restored.

The application cannot be run after a device wipe, until the following steps have been taken.

  • Any policy violations have been cleared, if possible, or policy settings have been changed by the enterprise administrator.
  • The application is terminated on the device, by using the native task manager, and then restarted, or the device is power-cycled, or the application is re-installed.

The application will then open as if being started for the first time. The user will then have to complete BlackBerry Dynamics activation.

◆ onUpdateConfig()

void onUpdateConfig ( Map< String, Object >  settings)

This callback will be invoked when an application configuration or other setting has been changed. This condition can be formally expressed as: when any value in the collection that would be returned by GDAndroid.getApplicationConfig is different.

Parameters
settingsMap<String, Object> containing the collection that would be returned if GDAndroid.getApplicationConfig were called now.

◆ onUpdatePolicy()

void onUpdatePolicy ( Map< String, Object >  policyValues)

This callback will be invoked when an application-specific policy setting has been changed. This condition can be formally expressed as: when any value in the collection that would be returned by GDAndroid.getApplicationPolicy is different.

Parameters
policyValuesMap<String, Object> containing the collection that would be returned if GDAndroid.getApplicationPolicy were called now.

◆ onUpdateServices()

void onUpdateServices ( )

This callback will be invoked when the BlackBerry Dynamics shared services configuration of one or more applications has changed. This condition can be formally expressed as: when the results of any possible GDAndroid.getServiceProvidersFor query has changed.

If the application has previously made a call to GDAndroid.getServiceProvidersFor and stored any part of the result, then that processing should be repeated when this callback is received.

◆ onUpdateEntitlements()

void onUpdateEntitlements ( )

This callback will be invoked when the entitlements data of the end user has changed. If the entitlements of the end user had previously been checked, by calling the GDAndroid.getEntitlementVersions method, then the entitlements should be checked again now.