|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
java.lang.Object | +--net.rim.device.api.applicationcontrol.ApplicationPermissionsManager
Allows applications to query the application control database to get their permissions and request additional permissions.
These settings can also be set manually by the user, through the options application.
Per-Domain Permissions
Some permissions can be set on a per-domain basis as well as globally. Appropriate methods therefore
are overloaded to accept a "domain" parameter to handle these cases. If such permissions are
specified to the overloaded versions that do not have a "domain" parameter then they will relate
to the default settings for domains.
The set of permissions that can be set on a per-domain basis are:
ApplicationPermissions.PERMISSION_BROWSER_FILTERApplicationPermissions.PERMISSION_EXTERNAL_CONNECTIONSApplicationPermissions.PERMISSION_INTERNAL_CONNECTIONS
| Method Summary | ||
|
ApplicationPermissions |
getApplicationPermissions()
Queries the application control database and returns the permissions of the calling application. |
|
static ApplicationPermissionsManager |
getInstance()
Returns the singleton instance of this class. |
|
int |
getMaxAllowable(int permission)
Returns the least restrictive value that a permission can possibly have for the calling application. |
|
int |
getMaxAllowable(int permission,
String domain)
Returns the least restrictive value that a permission can possibly have for a particular domain for the calling application. |
|
int |
getPermission(int permission)
Queries the application control database and returns the value of a permission of the calling application. |
|
int |
getPermission(int permission,
String domain)
Queries the application control database and returns the value of a permission of the calling application for a particular domain. |
|
boolean |
invokePermissionsRequest(ApplicationPermissions requestedPermissions)
Request application control permissions for the calling application. |
| Methods inherited from class java.lang.Object |
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
| Method Detail |
public ApplicationPermissions getApplicationPermissions()
ApplicationPermissions object containing the value to which
each permission is set in the application control database for the calling application;
never returns null.public static ApplicationPermissionsManager getInstance()
null.public int getMaxAllowable(int permission)
The system administrator is able to set a "maximum" value for each permission. The user
is not able to set any permission to be less restrive than the maximum enforced by the
system administrator. This method allows applications to determine if it is even possible
to obtain desired permissions and take appropriate action. Requesting a permission via
invokePermissionsRequest(net.rim.device.api.applicationcontrol.ApplicationPermissions) that is less restrictive than that allowed by the
system administrator will always return false.
For permissions that can be set on a per-domain basis, invoking this method with such permissions
is equivalent to invoking getMaxAllowable(int, String) and specifying null
for domain.
See Per-Domain Permissions for details about domain-specific permissions.
See Permission Values for details about the relative restrictiveness of the various values.
permission - the permission whose maximum value to get; valid values are any of the
PERMISSION_ constants defined in ApplicationPermissions.VALUE_
constants defined in ApplicationPermissions.IllegalArgumentException - if permission is not a valid value.
public int getMaxAllowable(int permission,
String domain)
getMaxAllowable(int) and
getPermission(int, String) for more information.
See Permission Values for details about the relative restrictiveness of the various values.
See Per-Domain Permissions for details about domain-specific permissions.
permission - the permission whose maximum value to get; valid values are any of the
PERMISSION_ constants defined in ApplicationPermissions
that can be set on a per-domain basis.domain - the domain to query; if null get the default value for domains
that do not have permissions explicitly set for them.VALUE_ constants defined
in the ApplicationPermissions class.IllegalArgumentException - if permission is not a valid value.public int getPermission(int permission)
For permissions that can be set on a per-domain basis, invoking this method with such permissions
is equivalent to invoking getPermission(int, String) and specifying null for
domain.
See Per-Domain Permissions for details about
domain-specific permissions.
permission - the permission whose value to get; must be equal to one of the permissions
constants defined in the ApplicationPermissions class.ApplicationPermissions.VALUE_ALLOW,
ApplicationPermissions.VALUE_PROMPT, or ApplicationPermissions.VALUE_DENY.IllegalArgumentException - if permission is not equal to one of the
permissions constants defined in the ApplicationPermissions class.
public int getPermission(int permission,
String domain)
See Per-Domain Permissions for details about domain-specific permissions.
permission - the permission whose value to get; valid values are any of the
PERMISSION_ constants defined in ApplicationPermissions
that can be set on a per-domain basis.domain - the domain to query; if null get the default value for domains
that do not have permissions explicitly set for them.VALUE_ constants defined in ApplicationPermissions.IllegalArgumentException - if permission is not a valid value.public boolean invokePermissionsRequest(ApplicationPermissions requestedPermissions)
An application can request it be assigned certain application control privlages by filling out an
ApplicationPermissions object, then submitting it to this method. The user will be presented
the application control screen, where they can review, and if they choose, save the supplied permissions.
The screen will be placed on top of the calling app and will block the calling thread until the user finishes
processing.
Checks will be performed against IT Policy, and the user will be prompted if the requested settings will not be allowed under the existing policy. (The application control screen does not allow them to save settings that conflict with the IT policy).
Note: If the calling application module is part of an application group, the requested permissions are applied to the ENTIRE group.
requestedPermissions - the permissions to request.true if the user accepts all of the requested permissions, or
false if the user or device policies reject at least one of the requested permissions.NullPointerException - if requestedPermissions is null
|
|||||||||
| PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
| SUMMARY: INNER | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD | ||||||||
Copyright 1999-2007 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.