Use this class to maintain a collection of information about particular
aspects of the BlackBerry Wireless Handheld such as connection
information. In particular, the service book is used to manage HTTP (MDS)
connections and mail (CMIME) information such as account and email hierarchy
information.
It is possible to listen for service book events through the
globalEventListener interface (refer to the GUID_* events).
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.
DUP_NONE
Represents a code indicating that there were no duplicate records.
static int
DUP_REMOVED
Represents a code indicating that there were duplicate records removed,
but nothing was replaced.
static int
DUP_REPLACED
Represents a code indicating that there were duplicate records removed.
static long
GUID_SB_ADDED
The GUID for the global event sent when a service book is added.
static long
GUID_SB_BR_END
The GUID for the global event sent when service book backup-restore
ends.
static long
GUID_SB_BR_START
The GUID for the global event sent when service book backup-restore
starts.
static long
GUID_SB_CHANGED
The GUID for the global event sent when a service book is changed.
static long
GUID_SB_OTA_SWITCH
The GUID for the global event sent when all service records are inserted
due to a move BES command OTA.
static long
GUID_SB_OTA_UPDATE
The GUID for the global event sent when all service records are updated
for a UID OTA.
static long
GUID_SB_PIN_CHANGE
The GUID for the global event sent when a service replaces an old service and the server
is reporting that the PIN last activated on that service has changed.
static long
GUID_SB_POLICY_CHANGED
The GUID for the global event sent when the service book responds to an
IT Policy changed event.
static long
GUID_SB_REMOVED
The GUID for the global event sent when a service book is removed.
getCIDAssociatedWithService(String targetCID,
int userID,
String dsID,
String uid)
Retrieve the a specific Service record with a target CID that is associated with another service record.
getRecordByCidAndUserId(String cid,
int userId,
int nameHash,
int uidHash)
Retrieves service record with a specified CID by user ID, if not found by user ID it
is the service record with the CID, name hash and UID hash is returned.
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.
ACK_SUCCESSFUL
public static final int ACK_SUCCESSFUL
Since:
JDE 4.0.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.
COMMAND_DELETE_SERVICE
public static final int COMMAND_DELETE_SERVICE
Since:
JDE 4.0.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.
COMMAND_INJECT_SERVICE
public static final int COMMAND_INJECT_SERVICE
Since:
JDE 4.0.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.
COMMAND_SERVICE_STATUS
public static final int COMMAND_SERVICE_STATUS
Since:
JDE 4.0.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.
COMMAND_SWITCH_SERVICE
public static final int COMMAND_SWITCH_SERVICE
Since:
JDE 4.0.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.
DUP_NONE
public static final int DUP_NONE
Represents a code indicating that there were no duplicate records.
Since:
JDE 4.0.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.
DUP_REMOVED
public static final int DUP_REMOVED
Represents a code indicating that there were duplicate records removed,
but nothing was replaced.
Since:
JDE 4.0.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.
DUP_REPLACED
public static final int DUP_REPLACED
Represents a code indicating that there were duplicate records removed.
In addtion, one record's internals were replaced by the master's. The
master record has now been removed.
Since:
JDE 4.0.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.
GUID_SB_ADDED
public static final long GUID_SB_ADDED
The GUID for the global event sent when a service book is added.
Since:
JDE 4.0.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.
GUID_SB_BR_END
public static final long GUID_SB_BR_END
The GUID for the global event sent when service book backup-restore
ends.
Since:
JDE 4.0.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.
GUID_SB_BR_START
public static final long GUID_SB_BR_START
The GUID for the global event sent when service book backup-restore
starts.
Since:
JDE 4.0.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.
GUID_SB_CHANGED
public static final long GUID_SB_CHANGED
The GUID for the global event sent when a service book is changed.
Since:
JDE 4.0.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.
GUID_SB_OTA_SWITCH
public static final long GUID_SB_OTA_SWITCH
The GUID for the global event sent when all service records are inserted
due to a move BES command OTA.
Since:
JDE 4.0.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.
GUID_SB_OTA_UPDATE
public static final long GUID_SB_OTA_UPDATE
The GUID for the global event sent when all service records are updated
for a UID OTA.
Since:
JDE 4.0.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.
GUID_SB_PIN_CHANGE
public static final long GUID_SB_PIN_CHANGE
The GUID for the global event sent when a service replaces an old service and the server
is reporting that the PIN last activated on that service has changed. (ie user switched devices)
Since:
JDE 4.2.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.
GUID_SB_POLICY_CHANGED
public static final long GUID_SB_POLICY_CHANGED
The GUID for the global event sent when the service book responds to an
IT Policy changed event.
Since:
JDE 4.1.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.
GUID_SB_REMOVED
public static final long GUID_SB_REMOVED
The GUID for the global event sent when a service book is removed.
Since:
JDE 4.0.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.
NEW_SERVER_UID
public static final int NEW_SERVER_UID
Since:
JDE 4.0.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.
RESULT_CUSTOM_ERROR
public static final int RESULT_CUSTOM_ERROR
Since:
JDE 4.0.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.
RESULT_DUPLICATE_SERVICE_ERROR
public static final int RESULT_DUPLICATE_SERVICE_ERROR
Since:
JDE 4.0.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.
RESULT_GENERAL_ERROR
public static final int RESULT_GENERAL_ERROR
Since:
JDE 4.0.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.
RESULT_KEY_ERROR
public static final int RESULT_KEY_ERROR
Since:
JDE 4.0.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.
RESULT_KEY_MISMATCH
public static final int RESULT_KEY_MISMATCH
Since:
JDE 4.0.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.
RESULT_PACKET_PARSE_ERROR
public static final int RESULT_PACKET_PARSE_ERROR
Since:
JDE 4.0.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.
RESULT_SECURITY_VIOLATION_ERROR
public static final int RESULT_SECURITY_VIOLATION_ERROR
Since:
JDE 4.0.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.
RESULT_SUCCESS
public static final int RESULT_SUCCESS
Since:
JDE 4.0.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.
RESULT_SWITCH_PENDING_ERROR
public static final int RESULT_SWITCH_PENDING_ERROR
Since:
JDE 4.0.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.
RESULT_UNKNOWN_COMMAND
public static final int RESULT_UNKNOWN_COMMAND
Since:
JDE 4.0.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.
RESULT_UNSUPPORTED_CMD_VERSION
public static final int RESULT_UNSUPPORTED_CMD_VERSION
Since:
JDE 4.0.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.
SB_GUID
public static final long SB_GUID
The GUID of the service book.
Since:
JDE 4.0.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.
SEND_ACK_FLAG
public static final int SEND_ACK_FLAG
Since:
JDE 4.0.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.
SERVICE_RECORD_SUMMARY_RECORD
public static final byte SERVICE_RECORD_SUMMARY_RECORD
Since:
JDE 4.1.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.
SERVICE_STATUS_FIELD
public static final int SERVICE_STATUS_FIELD
Since:
JDE 4.0.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.
SERVICEBOOK_PAYLOAD_VERSION_3
public static final int SERVICEBOOK_PAYLOAD_VERSION_3
Since:
JDE 4.0.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.
SOURCE_SERVER_UID
public static final int SOURCE_SERVER_UID
Since:
JDE 4.0.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.
STATUS_LAST_PIN
public static final int STATUS_LAST_PIN
Since:
JDE 4.0.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.
TO_BE_DELETED_SERVER_UID
public static final int TO_BE_DELETED_SERVER_UID
Since:
JDE 4.0.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.
VIEW_MODE_R
public static final int VIEW_MODE_R
Indicates that the service book has read view mode access.
Since:
JDE 4.0.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.
VIEW_MODE_RO
public static final int VIEW_MODE_RO
Indicates that the service book has read-only view mode access.
Since:
JDE 4.0.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.
VIEW_MODE_RW
public static final int VIEW_MODE_RW
Indicates that the service book has read-write view mode access.
Since:
JDE 4.0.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.
VIEW_MODE_UNKNOWN
public static final int VIEW_MODE_UNKNOWN
Indicates that the service book has an unknown view mode.
Since:
JDE 4.0.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.
Method Detail
commit
public void commit()
Commits changes to the persistent store.
This causes events to be transmitted to all listeners for any
changed, new or removed records.
Since:
JDE 4.0.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.
Allows an application to revoke the singleton restriction.
Parameters:
CID - The CID to register as a singleton.
Since:
JDE 4.2.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.
deRegisterCIDAsSingleton
public void deRegisterCIDAsSingleton(String CID,
boolean secureServices,
boolean insecureServices)
Allows an application to revoke the singleton restriction.
Parameters:
CID - The CID to register as a singleton.
secureServices - restricts secure services
insecureServices - restricts insecure services
Since:
JDE 4.2.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.
Retrieves any and all duplicates of the specified record.
It is possible to perform the search using different values for the
record's type, name, CID and UID. This way you can verify the
changes before they are actually committed. Any record which has the
same UID and CID or the same name and CID of the specified record will be
returned.
This routine will consider records depending on the type of the
argument record. If the argument record has type
ServiceRecord.SRT_ACTIVE, then records with the types
ServiceRecord.SRT_ACTIVE or ServiceRecord.SRT_OBSOLETE
are considered. Otherwise any considered records will have the same type
as the argument record.
newName - Record's new name or null if the name will not be changed.
newUid - Record's new UID or null if the UID will not be changed.
newCid - Record's new CID or null if the CID will not be changed.
dataSourceId - Record's new data-source ID or null if the
data-source ID will not be changed.
Returns:
Array of all matching duplicate service records.
Since:
JDE 4.0.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.
Retrieves all service records with specified content ID.
Note that the CID comparison is case insensitive.
Parameters:
cid - Content ID to match.
Returns:
Array of all service records with the specified CID.
Since:
JDE 4.2.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.
Retrieves all service records with specified name.
Parameters:
name - Name to match.
Returns:
Array of all service records with the specified name.
Since:
JDE 4.0.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.
Array of all service records with the specified type.
Since:
JDE 4.0.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.
Array of all service records with the specified UID.
Since:
JDE 4.0.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.
Retrieve the a specific Service record with a target CID that is associated with another service record.
Example: Services have atleast CID, UID and Name fields. Newer key fields include data source ID and user id.
If an application has a service record reference, often it is a requirement to find another service on the same server.
Eg: CICAL often needs to use CMIME services, so one would need to find the CMIME service record for this account.
This method will do the association from one Service record to a targeted CID.
If no association can be made, null is returned.
Parameters:
targetCID - - Content ID to match for.
userId - - user ID to match.
dsID - - datasource id to match.
uid - - uid to match.
Returns:
The associated service record.
Since:
JDE 4.2.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.
Retrieve the a specific Service record with a target CID that is associated with another service record.
Example: Services have atleast CID, UID and Name fields. Newer key fields include data source ID and user id.
If an application has a service record reference, often it is a requirement to find another service on the same server.
Eg: CICAL often needs to use CMIME services, so one would need to find the CMIME service record for this account.
This method will do the association from one Service record to a targeted CID.
If no association can be made, null is returned.
Parameters:
targetCID - Content ID to match for.
sr - The service record to match from.
Returns:
The associated service record.
Since:
JDE 4.2.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.
getNumRecords
public int getNumRecords(int type)
Retrieves the number of records with the specified type in the service
book.
Parameters:
type - Type of records to count.
Returns:
Number of records with the specified type.
Since:
JDE 4.0.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.
Retrieves service record by CID and data source ID.
Note that the CID comparison is case insensitive, while the data
source ID comparison is case sensitive.
Parameters:
cid - Content ID to match.
aDataSourceId - Data source ID to match.
Returns:
Service record that matched, or null if no matching record found.
Since:
JDE 4.0.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.
getRecordByCidAndHash
public ServiceRecordgetRecordByCidAndHash(String cid,
int nameHash,
int uidHash)
Retrieves service record by CID and either name hash or UID hash.
Service record that matched, or null if no matching record found.
Since:
JDE 4.0.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.
Retrieves service record by service identifier (sid)
Parameters:
cid - Content ID to match.
sid - the service identifier to match.
Returns:
The service record that matches, or null if no matching record is found.
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.
Service records that matched, or null if no matching records are found.
Since:
JDE 4.0.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.
getRecordByCidAndUserId
public ServiceRecordgetRecordByCidAndUserId(String cid,
int userId,
int nameHash,
int uidHash)
Retrieves service record with a specified CID by user ID, if not found by user ID it
is the service record with the CID, name hash and UID hash is returned.
Service records that matched, or null if no matching records are found.
Since:
JDE 4.1.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.
Service record associated with the ID, or null if no matching
record found.
Since:
JDE 4.0.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.
Note that the content ID and user ID comparisons are case
insensitive.
Parameters:
uid - User ID to match.
cid - Content ID to match.
Returns:
Service record associated with the UID and CID, or null if no
matching record found.
Since:
JDE 4.0.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.
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.
getSerialInjectionInProgress
public boolean getSerialInjectionInProgress()
Gets the current state of serial service record injection
Returns:
flag True if serial injection is occuring; false otherwise
Since:
JDE 4.0.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.
getServiceList
public byte[] getServiceList()
Get the Service Record list summary encoding
(used by the Device Agent Database.)
Returns:
TLE encoded list of service records and their key values.
Since:
JDE 4.1.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.
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.
Verifies that a record is allowed in the current book, according to IT
policy settings.
Checks the record against the current IT policy. It is possible to
do the search with different values for the record's type, name, CID and
UID. This way it is possible to verify changes before they are actually
commited to the service book.
Parameters:
sr - Record to check.
newType - Record's new type or SRT_NO_CHANGE if the
type will not be changed.
newName - Record's new name or null if the name will not be changed.
newUid - Record's new UID or null if the uid will not be changed.
newCid - Record's new CID or null if the cid will not be changed.
Returns:
True if the record is allowed (passes the IT policy check);
otherwise, false.
Since:
JDE 4.0.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.
Allows an application to indicate that only one CID is supported.
Duplicate service records of this CID are not allowed.
The last in service record will overwrite the previous record.
Parameters:
CID - The CID to register as a singleton.
Since:
JDE 4.0.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.
registerCIDAsSingleton
public void registerCIDAsSingleton(String CID,
boolean secureServices,
boolean insecureServices)
Allows an application to indicate that only one CID is supported.
Duplicate service records of this CID are not allowed.
The last in service record will overwrite the previous record.
Parameters:
CID - The CID to register as a singleton.
secureServices - restricts secure services
insecureServices - restricts insecure services
Since:
JDE 4.2.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.
setSerialInjectionInProgress
public void setSerialInjectionInProgress(boolean flag)
Sets current state of serial service record injection
Parameters:
flag - True if serial injection is occuring; false otherwise
Since:
JDE 4.0.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.
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.