net.rim.device.api.itpolicy
Class ITPolicy

java.lang.Object
  |
  +--net.rim.device.api.itpolicy.ITPolicy

public final class ITPolicy
extends Object

Provides access to the IT policy database.

IT Policy is used by BlackBerry system administrators to govern the desktop and handheld settings of individual BlackBerry handheld users. IT policies enable system administrators to customize the features that are common to all BlackBerry handheld users on a given BlackBerry Enterprise Server, such as password details and convenience settings like mail forwarding options and browser settings.

IT policies provide an efficient method for managing many different users simultaneously.

Since:
JDE 3.6.0

Field Summary
static long GUID_IT_POLICY_CHANGED
          The GUID for the global event sent when the IT Policy changes.
static long GUID_IT_POLICY_CHANGED_LOCKED_HANDHELD
          The GUID for the global event sent when the IT Policy changes and handheld locking is required
static long GUID_PASSWORD_SET_BY_ITADMIN
          The GUID for the global event sent when the password is changed by the BES administrator.
static int PUBLIC_KEY_TAG
          Represents the public key sub tag (for use with ITPOLICY_VERIFICATION_KEYS tag)
static int SIGNATURE_KEY_TAG
          Represents the signature key sub tag (for use with ITPOLICY_SIGNATURE_KEYS tag)
static int TERNARY_FALSE
          Represents the ternary false value.
static int TERNARY_PROMPT
          Represents the ternary prompt value.
static int TERNARY_TRUE
          Represents the ternary true value.
 
Method Summary
static boolean getBoolean(int id, boolean defaultValue)
          Returns a boolean value from the IT policy database.
static boolean getBoolean(int group, int id, boolean defaultValue)
          Returns a boolean value from the IT policy database given the group key, the ID and a boolean representing the default value.
static boolean getBoolean(String name, boolean defaultValue)
          Returns a boolean value from the IT policy database given the name of the parameter and its default value.
static byte getByte(int id, byte defaultValue)
          Returns a byte value from the IT policy database.
static byte getByte(int group, int id, byte defaultValue)
          Returns a byte value from the IT policy database.
static byte getByte(String name)
          Returns a byte value from the IT policy database given the name of the parameter.
static byte[] getByteArray(int id)
          Returns a byte array from the IT policy database.
static byte[] getByteArray(int group, int id)
          Returns a byte array from the IT policy database given the group key and ID.
static byte[] getByteArray(String name)
          Returns a byte array from the IT policy database given the name of the byte array.
static int getInteger(int id, int defaultValue)
          Returns an integer value from the IT policy database given the ID and default value.
static int getInteger(int group, int id, int defaultValue)
          Returns an integer value from the IT policy database.
static int getInteger(String name, int defaultValue)
          Returns an integer value from the IT policy database given the name of the parameter and its default value.
static String getString(int id)
          Returns a string value from the IT policy database.
static String getString(int group, int id)
          Returns a string value from the IT policy database given the group key and ID.
static String getString(String name)
          Returns a string value from the IT policy database given the name of the string.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail


GUID_IT_POLICY_CHANGED

public static final long GUID_IT_POLICY_CHANGED
The GUID for the global event sent when the IT Policy changes.
Since:
JDE 3.6.0

GUID_IT_POLICY_CHANGED_LOCKED_HANDHELD

public static final long GUID_IT_POLICY_CHANGED_LOCKED_HANDHELD
The GUID for the global event sent when the IT Policy changes and handheld locking is required
Since:
JDE 4.0.0

GUID_PASSWORD_SET_BY_ITADMIN

public static final long GUID_PASSWORD_SET_BY_ITADMIN
The GUID for the global event sent when the password is changed by the BES administrator.
Since:
JDE 4.3.0

PUBLIC_KEY_TAG

public static final int PUBLIC_KEY_TAG
Represents the public key sub tag (for use with ITPOLICY_VERIFICATION_KEYS tag)
Since:
JDE 4.0.2

SIGNATURE_KEY_TAG

public static final int SIGNATURE_KEY_TAG
Represents the signature key sub tag (for use with ITPOLICY_SIGNATURE_KEYS tag)
Since:
JDE 4.0.2

TERNARY_FALSE

public static final int TERNARY_FALSE
Represents the ternary false value.
Since:
JDE 3.6.0

TERNARY_PROMPT

public static final int TERNARY_PROMPT
Represents the ternary prompt value.
Since:
JDE 3.6.0

TERNARY_TRUE

public static final int TERNARY_TRUE
Represents the ternary true value.
Since:
JDE 3.6.0
Method Detail

getBoolean

public static boolean getBoolean(int id,
                                 boolean defaultValue)
Returns a boolean value from the IT policy database.

Parameters:
id - The parameter id.
defaultValue - The value to be returned if no entry was found.
Returns:
The parameter value.
Since:
JDE 3.6.0

getBoolean

public static boolean getBoolean(int group,
                                 int id,
                                 boolean defaultValue)
Returns a boolean value from the IT policy database given the group key, the ID and a boolean representing the default value.

Parameters:
group - The group key.
id - The parameter id belonging to this group.
defaultValue - The value to be returned if no entry was found.
Returns:
The parameter value.
Since:
JDE 3.6.0

getBoolean

public static boolean getBoolean(String name,
                                 boolean defaultValue)
Returns a boolean value from the IT policy database given the name of the parameter and its default value.

Parameters:
name - The parameter name.
defaultValue - The value to be returned if no entry was found.
Returns:
The parameter value.
Since:
JDE 3.6.0

getByte

public static byte getByte(int id,
                           byte defaultValue)
Returns a byte value from the IT policy database.

Parameters:
id - The parameter id.
defaultValue - The value to be returned if no entry was found.
Returns:
The parameter value.
Since:
JDE 3.6.0

getByte

public static byte getByte(int group,
                           int id,
                           byte defaultValue)
Returns a byte value from the IT policy database.

Parameters:
group - The group key.
id - The parameter id belong to this group.
defaultValue - The value to be returned if no entry was found.
Returns:
The parameter value.
Since:
JDE 3.6.0

getByte

public static byte getByte(String name)
Returns a byte value from the IT policy database given the name of the parameter.

Parameters:
name - The parameter name.
Returns:
The parameter value, or a null byte ('\0') if no entry was found.
Since:
JDE 3.6.0

getByteArray

public static byte[] getByteArray(int id)
Returns a byte array from the IT policy database.

Parameters:
id - The parameter id.
Returns:
The parameter value, or null if no entry was found.
Since:
JDE 3.6.0

getByteArray

public static byte[] getByteArray(int group,
                                  int id)
Returns a byte array from the IT policy database given the group key and ID.

Parameters:
group - The group key.
id - The parameter id that belongs to this group.
Returns:
The parameter value, or null if no entry was found.
Since:
JDE 3.6.0

getByteArray

public static byte[] getByteArray(String name)
Returns a byte array from the IT policy database given the name of the byte array.

Parameters:
name - The parameter name.
Returns:
The parameter value, or null if no entry was found.
Since:
JDE 3.6.0

getInteger

public static int getInteger(int id,
                             int defaultValue)
Returns an integer value from the IT policy database given the ID and default value.

Parameters:
id - The parameter id.
defaultValue - The value to be returned if no entry was found.
Returns:
The parameter value.
Since:
JDE 3.6.0

getInteger

public static int getInteger(int group,
                             int id,
                             int defaultValue)
Returns an integer value from the IT policy database.

Parameters:
group - The group key.
id - The parameter id belonging to this group.
defaultValue - The value to be returned if no entry was found.
Returns:
The parameter value.
Since:
JDE 3.6.0

getInteger

public static int getInteger(String name,
                             int defaultValue)
Returns an integer value from the IT policy database given the name of the parameter and its default value.

Parameters:
name - The parameter name.
defaultValue - The value to be returned if no entry was found.
Returns:
The parameter value.
Since:
JDE 3.6.0

getString

public static String getString(int id)
Returns a string value from the IT policy database.

Parameters:
id - The parameter id.
Returns:
The parameter value, or null if no entry was found.
Since:
JDE 3.6.0

getString

public static String getString(int group,
                               int id)
Returns a string value from the IT policy database given the group key and ID.

Parameters:
group - The group key.
id - The parameter id belonging to this group.
Returns:
The parameter value, or null if no entry was found.
Since:
JDE 3.6.0

getString

public static String getString(String name)
Returns a string value from the IT policy database given the name of the string.

Parameters:
name - The parameter name.
Returns:
The parameter value, or null if no entry was found.
Since:
JDE 3.6.0



Copyright 1999-2009 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.