This class contains a set of constants whose names begin with PERMISSION_
(for example PERMISSION_BLUETOOTH). Each one of these "permissions"
refers to a particular subset of the API that can be restricted by that application control.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_BROWSER_FILTER
public static final int PERMISSION_BROWSER_FILTER
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_CHANGE_DEVICE_SETTINGS
public static final int PERMISSION_CHANGE_DEVICE_SETTINGS
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_CODE_MODULE_MANAGEMENT
public static final int PERMISSION_CODE_MODULE_MANAGEMENT
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_EMAIL
public static final int PERMISSION_EMAIL
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_EVENT_INJECTOR
public static final int PERMISSION_EVENT_INJECTOR
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_EXTERNAL_CONNECTIONS
public static final int PERMISSION_EXTERNAL_CONNECTIONS
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_FILE_API
public static final int PERMISSION_FILE_API
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_HANDHELD_KEYSTORE
public static final int PERMISSION_HANDHELD_KEYSTORE
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_IDLE_TIMER
public static final int PERMISSION_IDLE_TIMER
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_INTER_PROCESS_COMMUNICATION
public static final int PERMISSION_INTER_PROCESS_COMMUNICATION
Since:
JDE 4.3.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_INTERNAL_CONNECTIONS
public static final int PERMISSION_INTERNAL_CONNECTIONS
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_KEYSTORE_MEDIUM_SECURITY
public static final int PERMISSION_KEYSTORE_MEDIUM_SECURITY
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_LOCAL_CONNECTIONS
public static final int PERMISSION_LOCAL_CONNECTIONS
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_LOCATION_API
public static final int PERMISSION_LOCATION_API
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_MEDIA
public static final int PERMISSION_MEDIA
Since:
JDE 4.3.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_PHONE
public static final int PERMISSION_PHONE
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_PIM
public static final int PERMISSION_PIM
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_SCREEN_CAPTURE
public static final int PERMISSION_SCREEN_CAPTURE
Since:
JDE 4.3.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_THEME_DATA
public static final int PERMISSION_THEME_DATA
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
PERMISSION_WIFI
public static final int PERMISSION_WIFI
Since:
JDE 4.3.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
VALUE_ALLOW
public static final int VALUE_ALLOW
A constant representing a permission's value of "allow".
If a permission is set to this value then it may use APIs controlled by the permission.
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
VALUE_DENY
public static final int VALUE_DENY
A constant representing a permission's value of "deny".
If a permission is set to this value then it may not use APIs controlled by the permission.
Methods that are invoked when the corresponding Application Control is set to "deny" will
throw an exception.
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
VALUE_PROMPT
public static final int VALUE_PROMPT
A constant representing a permission's value of "prompt".
If a permission is set to this value then it may use APIs controlled by the permission,
but the user will be prompted upon the first usage and potentially subsequent uses.
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Constructor Detail
ApplicationPermissions
public ApplicationPermissions()
Creates a new empty ApplicationPermissions object.
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
Method Detail
addPermission
public void addPermission(int permission)
Adds a permission with the value VALUE_ALLOW.
If the specified permission has already been added
(that is, this.containsPermissionKey(permission) returns true)
then its value is overwritten with VALUE_ALLOW.
Parameters:
permission - the permission to add with the value VALUE_ALLOW; valid values
are any of the PERMISSION_ constants.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
containsPermissionKey
public boolean containsPermissionKey(int permission)
Returns whether or not a permission has been added.
A permission is considered to have been "added" if and only if it is contained in the
array returned from getPermissionKeys().
Parameters:
permission - the permission to test for having been added; valid values are any of the
PERMISSION_ constants.
Returns:
true if the specified permission has been added; false
otherwise.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
other - the ApplicationPermissions object to compare to this.
Returns:
the set of permissions in this object whose values are different than
those of other, as defined above, or an empty array if there is no such
difference; never returns null.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
getPermission
public int getPermission(int permission)
Returns the value for a permission.
Parameters:
permission - the permission whose value to return; valid values are any of the
PERMISSION_ constants.
Returns:
the value of the specified permission; will be equal to one of the
VALUE_ constants.
Throws:
IllegalArgumentException - if permission is not a valid value or if
permission has not been added; that is,
this.containsPermissionKey(permission) returns false.
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
getPermissionKeys
public int[] getPermissionKeys()
Returns the set of permissions that have been added.
Returns:
the set of permissions that have been added, or an empty array if
none have been added; never returns null; each element of the returned array
will be equal to one of the permission constants defined in this class.
Since:
JDE 4.2.1
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.
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.