Listener interface for authorization state transitions, and other events dispatched from the BlackBerry Dynamics runtime. More...
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... | |
void onAuthorized | ( | ) |
This callback will be invoked when:
void onLocked | ( | ) |
This callback will be invoked when the user interface of the application has been locked, for example:
If the condition that caused locking is cleared, for example if the user stops being idle, then the onAuthorized callback will be invoked.
void onWiped | ( | ) |
This callback will be invoked when the authorization of the user has been permanently withdrawn, for example:
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.
The application will then open as if being started for the first time. The user will then have to complete BlackBerry Dynamics activation.
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.
settings | Map<String, Object> containing the collection that would be returned if GDAndroid.getApplicationConfig were called now. |
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.
policyValues | Map<String, Object> containing the collection that would be returned if GDAndroid.getApplicationPolicy were called now. |
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.
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.