net.rim.device.api.servicebook
Class ServiceRecord
java.lang.Object
net.rim.device.api.servicebook.ServiceRecord
- All Implemented Interfaces:
- Persistable
public final class ServiceRecord
- extends Object
- implements Persistable
Represents a service record that contains BlackBerry configuration
information.
Service records, which are contained within ServiceBooks, are
used to store information about BlackBerry device connections such as MDS and
CMIME. Similar to a registry, service records allow you to keep
track of and change the configuration settings of a BlackBerry
device.
This has the ability to control an individual record as well as parse a
DataBuffer into a new record.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
|
Field Summary |
|
static int |
CDMA_WIRELESS_NET_TYPE
CDMA Network. |
|
static int |
COMPRESS_NONE
Indicates no compression mode. |
|
static int |
COMPRESS_RIM
Indicates RIM-proprietary compression mode. |
|
static int |
ENCRYPTED_ENCRYPTION_MODES
Indicates the encryption modes that are considered encrypted. |
|
static int |
ENCRYPT_NONE
Indicates no encryption mode. |
|
static int |
ENCRYPT_RIM
Indicates RIM encryption (3DES or AES)
Note: This is the default encryption mode. |
|
static int |
ENCRYPT_RIM_SIGNED
Indicates RIM BIS signing (HMAC-SHA256) |
|
static int |
ENCRYPT_RIM_WEAK
Indicates RIM BIS encryption (3DES or AES)
Note: If this encrypt mode is specified, the service is treated as insecure. |
|
static int |
GPRS_WIRELESS_NET_TYPE
GPRS Network. |
|
static int |
IDEN_WIRELESS_NET_TYPE
IDEN Network |
|
static int |
INVALID_COMPRESSION_MODES
Indicates an invalid compression mode. |
|
static int |
INVALID_ENCRYPTION_MODES
Indicates an invalid encryption mode. |
|
static int |
INVALID_RECORD_ID
Indicates an invalid record ID. |
|
static int |
INVALID_USER_ID
Indicates an invalid user ID. |
|
static int |
MAJOR_VERSION
Current major version of the ServiceRecords/ServiceBook. |
|
static int |
MINOR_VERSION
Current minor version of the ServiceRecord/ServiceBook. |
|
static int |
MOBITEX_WIRELESS_NET_TYPE
Deprecated. Mobitex is no longer supported. |
|
static int |
NUM_SOURCES
Indicates the total number of record source types. |
|
static int |
SECURED_ENCRYPTION_MODES
Indicates the encryption modes that are considered secured. |
|
static int |
SOURCE_CODE
Type indicates the record's source was programmatic. |
|
static int |
SOURCE_EDITOR
Type indicates the record's source was the SB Editor (user operated or
otherwise). |
|
static int |
SOURCE_OTA
Type indicates the record's source was over the air. |
|
static int |
SOURCE_OTA_SECURE
Type indicates the record's source was a secure over-the-air connection. |
|
static int |
SOURCE_SERIAL
Type indicates the record's source was a serial link. |
|
static int |
SOURCE_UNKNOWN
Type indicates an unknown source. |
|
static int |
SRT_ACTIVE
Type indicates a service record that's in use. |
|
static int |
SRT_DISALLOWED
Type indicates a record disallowed by local IT Policy. |
|
static int |
SRT_GHOST
Type indicates a record deleted but sill recoverable. |
|
static int |
SRT_NO_CHANGE
Indicates service record type will not change. |
|
static int |
SRT_NUM_TYPES
Indicates the number of different service record types. |
|
static int |
SRT_OBSOLETE
Type indicates a record with an old version (0x00). |
|
static int |
SRT_ORPHAN
Type indicates a record usable but not in the service book. |
|
static int |
SRT_PENDING
Type indicates a record received but not yet accepted (or rejected). |
|
static int |
SRT_UNKNOWN
Type of service record is unknown. |
|
static int |
VERSION
Current version of the ServiceRecord/ServiceBook. |
|
Constructor Summary |
|
ServiceRecord()
Creates a new service record instance, setting up initial values. |
|
ServiceRecord(int source)
Constructs a new service record from the given source. |
|
Method Summary |
|
void |
copyInto(ServiceRecord sr)
Copies the data from this service record into another. |
|
String |
getAPN()
Retrieves this record's associated access point name. |
|
byte[] |
getApplicationData()
Retrieves this service record's application-specific data. |
|
String[] |
getBBRHosts()
Retrieves list of BBR hosts for this record. |
|
int[] |
getBBRPorts()
Retrieves list of BBR ports for this record. |
|
String |
getCAAddress()
Retrieves the address for this record's associated certificate authority. |
|
short |
getCAPort()
Retrieves the port for this record's associated certificate authority. |
|
String |
getCARealm()
Retrieves this record's associated certificate authority. |
|
String |
getCid()
Retrieves this service record's CID. |
|
int |
getCidHash()
Retrieves this service record's hashed CID (SHA-1 hash). |
|
int |
getCompressionMode()
Retrieves server's available compression mode. |
|
String |
getDataSourceId()
Retrieves this record's data source ID. |
|
String |
getDescription()
Retrieves the textual description of this record. |
|
boolean |
getDisabledState()
Determines this record's disabled state. |
|
int |
getEncryptionMode()
Retrieves server's available encryption mode. |
|
String |
getHomeAddress()
Retrieves this record's home address. |
|
int |
getId()
Retrieves this service record's ID. |
|
int |
getKeyHashForService()
getHashCodeForService. |
|
long |
getLastUpdated()
Retrieves time this record was last updated |
|
String |
getName()
Retrieves this service record's name. |
|
int |
getNameHash()
Returns this service record's hashed name (SHA-1 hash). |
|
String |
getNetworkAddress()
Retrieves this record's associated network address. |
|
int |
getNetworkType()
Retrieves this record's associated network type. |
|
short |
getServiceIdentifierSubType()
Retrieves the Service Identifier Sub Type |
|
short |
getServiceIdentifierType()
Retrieves the service Identifier Type |
|
int |
getSource()
Retrieves this record's source type. |
|
String |
getSourceIdentity()
Retrieves the source Identifier |
|
Transport |
getTransport()
Retrieves this service record's associated transport object using this service record's CID. |
|
int |
getType()
Retrieves this service record's type. |
|
String |
getUid()
Retrieves this service record's UID. |
|
int |
getUidHash()
Retrieves this service record's hashed UID (SHA-1 hash). |
|
int |
getUserId()
Retrieves this record's user ID. |
|
String |
getUserIdentity()
Retrieves the User Identifier |
|
boolean |
isDirty()
Determines if this record has unsaved changes. |
|
boolean |
isDisabled()
Determines if this record is disabled. |
|
boolean |
isDuplicate(ServiceRecord rec,
int newType,
String newName,
String newUid,
String newCid,
String newDataSourceId,
int newUserId)
Determines if the specified record is a duplicate of this record. |
|
boolean |
isDuplicate(ServiceRecord rec,
int newType,
String newName,
String newUid,
String newCid,
String newDataSourceId,
int newUserId,
String newUserIdentity,
String newSourceIdentity)
Determines if the specified record is a duplicate of this record. |
|
boolean |
isEncrypted()
Deprecated. as of 5.0.0, replaced by ServiceRecord.isEncryptedService(), ServiceRecord.isSignedOrEncrypted() |
|
boolean |
isEncryptedService()
Determines if this record's associated service is an encrypted service. |
|
boolean |
isInsecureService()
Determines if this record's associated service is insecure. |
|
boolean |
isInvisible()
Determines if this record should be visible to the end user. |
|
boolean |
isRecordProtected()
Determines if this record is protected. |
|
boolean |
isRestoreDisabled()
Determines if this record is disabled for backup/restore |
|
boolean |
isRestoreEnabled()
Determines if this record is disabled for backup/restore |
|
boolean |
isRestoredFromBackup()
Determines if this record was restored from a backup |
|
boolean |
isSecureService()
Deprecated. as of 5.0.0, replaced by ServiceRecord.isStrongSecureService() |
|
boolean |
isSignedOrEncrypted()
Determines if this record's associated service is a signed or encrypted service. |
|
boolean |
isSignedService()
Determines if this record's associated service is a signed service. |
|
boolean |
isStrongSecureService()
Determines if this record's associated service is strong secure. |
|
boolean |
isValid()
Determines if this record is valid. |
|
boolean |
isWeakSecureService()
Determines if this record's associated service is weakly secure. |
|
String |
toString()
toString implementation |
MOBITEX_WIRELESS_NET_TYPE
public static final int MOBITEX_WIRELESS_NET_TYPE
- Deprecated. Mobitex is no longer supported.
- Mobitex network.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.2
GPRS_WIRELESS_NET_TYPE
public static final int GPRS_WIRELESS_NET_TYPE
- GPRS Network.
- See Also:
ServiceRecord.getNetworkType(),
Constant Field Values- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
CDMA_WIRELESS_NET_TYPE
public static final int CDMA_WIRELESS_NET_TYPE
- CDMA Network.
- See Also:
ServiceRecord.getNetworkType(),
Constant Field Values- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
IDEN_WIRELESS_NET_TYPE
public static final int IDEN_WIRELESS_NET_TYPE
- IDEN Network
- See Also:
ServiceRecord.getNetworkType(),
Constant Field Values- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
MAJOR_VERSION
public static final int MAJOR_VERSION
- Current major version of the ServiceRecords/ServiceBook.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
MINOR_VERSION
public static final int MINOR_VERSION
- Current minor version of the ServiceRecord/ServiceBook.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
VERSION
public static final int VERSION
- Current version of the ServiceRecord/ServiceBook.
Must be either ServiceRecord.MAJOR_VERSION or ServiceRecord.MINOR_VERSION.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SRT_NO_CHANGE
public static final int SRT_NO_CHANGE
- Indicates service record type will not change.
This constant is used during calls to ServiceRecord.isDuplicate(net.rim.device.api.servicebook.ServiceRecord, int, java.lang.String, java.lang.String, java.lang.String, java.lang.String, int) to
indicate that the type will not be changed.
Note: This is not a valid type to assign to a record.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SRT_ACTIVE
public static final int SRT_ACTIVE
- Type indicates a service record that's in use.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SRT_PENDING
public static final int SRT_PENDING
- Type indicates a record received but not yet accepted (or rejected).
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SRT_GHOST
public static final int SRT_GHOST
- Type indicates a record deleted but sill recoverable.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SRT_OBSOLETE
public static final int SRT_OBSOLETE
- Type indicates a record with an old version (0x00).
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SRT_UNKNOWN
public static final int SRT_UNKNOWN
- Type of service record is unknown.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SRT_ORPHAN
public static final int SRT_ORPHAN
- Type indicates a record usable but not in the service book.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SRT_DISALLOWED
public static final int SRT_DISALLOWED
- Type indicates a record disallowed by local IT Policy.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SRT_NUM_TYPES
public static final int SRT_NUM_TYPES
- Indicates the number of different service record types.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
ENCRYPT_NONE
public static final int ENCRYPT_NONE
- Indicates no encryption mode.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
ENCRYPT_RIM
public static final int ENCRYPT_RIM
- Indicates RIM encryption (3DES or AES)
Note: This is the default encryption mode.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
ENCRYPT_RIM_WEAK
public static final int ENCRYPT_RIM_WEAK
- Indicates RIM BIS encryption (3DES or AES)
Note: If this encrypt mode is specified, the service is treated as insecure.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.2.0
ENCRYPT_RIM_SIGNED
public static final int ENCRYPT_RIM_SIGNED
- Indicates RIM BIS signing (HMAC-SHA256)
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 5.0.0
INVALID_ENCRYPTION_MODES
public static final int INVALID_ENCRYPTION_MODES
- Indicates an invalid encryption mode.
Note: This constant represents all the invalid encryption
modes. A high bit means that mode is not allowed.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
ENCRYPTED_ENCRYPTION_MODES
public static final int ENCRYPTED_ENCRYPTION_MODES
- Indicates the encryption modes that are considered encrypted.
Note: This constant represents all encryption modes that are
considered to be encrypted vs. the signing encryption mode and no
encryption mode which is not encrypted.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 5.0.0
SECURED_ENCRYPTION_MODES
public static final int SECURED_ENCRYPTION_MODES
- Indicates the encryption modes that are considered secured.
Note: This constant represents all encryption modes that are
considered to be secured vs. insecure.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 5.0.0
COMPRESS_NONE
public static final int COMPRESS_NONE
- Indicates no compression mode.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
COMPRESS_RIM
public static final int COMPRESS_RIM
- Indicates RIM-proprietary compression mode.
Note: This is the default compression mode.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
INVALID_COMPRESSION_MODES
public static final int INVALID_COMPRESSION_MODES
- Indicates an invalid compression mode.
Note: This constant represents all the invalid compression
modes. A high bit means that mode is not allowed.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
INVALID_RECORD_ID
public static final int INVALID_RECORD_ID
- Indicates an invalid record ID.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
INVALID_USER_ID
public static final int INVALID_USER_ID
- Indicates an invalid user ID.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SOURCE_UNKNOWN
public static final int SOURCE_UNKNOWN
- Type indicates an unknown source.
Note: This source should only be used for records that are
restored to the device without source information.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SOURCE_SERIAL
public static final int SOURCE_SERIAL
- Type indicates the record's source was a serial link.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SOURCE_OTA
public static final int SOURCE_OTA
- Type indicates the record's source was over the air.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SOURCE_CODE
public static final int SOURCE_CODE
- Type indicates the record's source was programmatic.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SOURCE_EDITOR
public static final int SOURCE_EDITOR
- Type indicates the record's source was the SB Editor (user operated or
otherwise).
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
SOURCE_OTA_SECURE
public static final int SOURCE_OTA_SECURE
- Type indicates the record's source was a secure over-the-air connection.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
NUM_SOURCES
public static final int NUM_SOURCES
- Indicates the total number of record source types.
- See Also:
- Constant Field Values
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
ServiceRecord
public ServiceRecord()
- Creates a new service record instance, setting up initial values.
Note that before the record is added to the service book, you must
set the type, name, UID and CID. This is the default constructor.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
ServiceRecord
public ServiceRecord(int source)
- Constructs a new service record from the given source.
- Parameters:
source - Source from which to create the service record,- See Also:
ServiceRecord.getSource()- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getUserIdentity
public String getUserIdentity()
- Retrieves the User Identifier
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 7.1.0
getSourceIdentity
public String getSourceIdentity()
- Retrieves the source Identifier
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 7.1.0
getServiceIdentifierType
public short getServiceIdentifierType()
- Retrieves the service Identifier Type
- Returns:
- The service Identifier Type, one of the following
ServiceIdentifierTypes.BLACKBERRY_ENTERPRISE_SERVER,
ServiceIdentifierTypes.BLACKBERRY_INTERNET_SERVICE,
ServiceIdentifierTypes.BLACKBERRY_UNITE - See Also:
ServiceIdentifierTypes- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.1.0
getServiceIdentifierSubType
public short getServiceIdentifierSubType()
- Retrieves the Service Identifier Sub Type
- Returns:
- The service Identifier SubType, one of the following
ServiceIdentifierTypes.MICROSOFT_EXCHANGE_SERVER,
ServiceIdentifierTypes.LOTUS_DOMINO_SERVER,
ServiceIdentifierTypes.NOVELL_GROUPWISE_SERVER - See Also:
ServiceIdentifierTypes- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.1.0
getLastUpdated
public long getLastUpdated()
- Retrieves time this record was last updated
- Returns:
- time this record was last updated.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.2
getId
public int getId()
- Retrieves this service record's ID.
Use this method to (effectively) retrieve a handle into the service
book.
Note: This method is only useful after this record has been
added to the service book.
- Returns:
- ID of this record.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getType
public int getType()
- Retrieves this service record's type.
This method will return one of the
SRT_ constants defined in this class.
For reference, some are listed below:
- Returns:
- Type of this record; will be equal to one of the
SRT_ constants
defined in this class. - Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getName
public String getName()
- Retrieves this service record's name.
- Returns:
- Name of this record.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getNameHash
public int getNameHash()
- Returns this service record's hashed name (SHA-1 hash).
- Returns:
- Hashed name for this record.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getUid
public String getUid()
- Retrieves this service record's UID.
- Returns:
- UID of this record; should be treated as case-insensitive.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getUidHash
public int getUidHash()
- Retrieves this service record's hashed UID (SHA-1 hash).
Note: The UID is converted to lower-case before the hash is
made.
- Returns:
- Hashed UID for this record.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getCid
public String getCid()
- Retrieves this service record's CID.
Note: The CID should to be treated as case-insensitive.
- Returns:
- CID of this record; should be treated as case-insensitive.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getCidHash
public int getCidHash()
- Retrieves this service record's hashed CID (SHA-1 hash).
Note: The CID is converted to lower-case before the hash is
made.
- Returns:
- Hashed CID for this record.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getApplicationData
public byte[] getApplicationData()
- Retrieves this service record's application-specific data.
- Returns:
- Application specific data in a byte array, or null if there isn't
any.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getEncryptionMode
public int getEncryptionMode()
- Retrieves server's available encryption mode.
Currently, the available encryption modes are
ServiceRecord.ENCRYPT_NONE,
ServiceRecord.ENCRYPT_RIM (3DES or AES),
ServiceRecord.ENCRYPT_RIM_WEAK (3DES or AES).
- Returns:
- Server's available encryption mode value.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getCompressionMode
public int getCompressionMode()
- Retrieves server's available compression mode.
Currently, the available compression modes are
ServiceRecord.COMPRESS_NONE, and
ServiceRecord.COMPRESS_RIM.
- Returns:
- Server's available compression mode value.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getCARealm
public String getCARealm()
- Retrieves this record's associated certificate authority.
- Returns:
- CA for this record or null if there isn't one.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getCAAddress
public String getCAAddress()
- Retrieves the address for this record's associated certificate authority.
- Returns:
- Address of this record's CA or null if it doesn't have one.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getCAPort
public short getCAPort()
- Retrieves the port for this record's associated certificate authority.
- Returns:
- Port of this record's CA.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getNetworkAddress
public String getNetworkAddress()
- Retrieves this record's associated network address.
The retrieved address corresponds to the gateway to which the service
is attached. For instance, on the GPRS networks, this will be an IP
address in octet form.
- Returns:
- Network address of the gateway associated with this service, or null
if none is associated currently.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getNetworkType
public int getNetworkType()
- Retrieves this record's associated network type.
The retrieved value corresponds to one of the following types:
ServiceRecord.CDMA_WIRELESS_NET_TYPE,
ServiceRecord.GPRS_WIRELESS_NET_TYPE,
ServiceRecord.IDEN_WIRELESS_NET_TYPE, or
ServiceRecord.MOBITEX_WIRELESS_NET_TYPE.
- Returns:
- Network type value, or -1 if this record isn't associated with
any network.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getAPN
public String getAPN()
- Retrieves this record's associated access point name.
The retrieved APN corresponds to the gateway to which the service is
attached.
- Returns:
- APN of the gateway associated with this service, or null if no
APN applies.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getDescription
public String getDescription()
- Retrieves the textual description of this record.
- Returns:
- Text description for this record, or null if it doesn't have one.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
isRecordProtected
public boolean isRecordProtected()
- Determines if this record is protected.
- Returns:
- True if the record is protected; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
isRestoredFromBackup
public boolean isRestoredFromBackup()
- Determines if this record was restored from a backup
- Returns:
- True if the record is protected; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
isDirty
public boolean isDirty()
- Determines if this record has unsaved changes.
The record is considered dirty if one of its member variables has
changed, and the record has not yet been committed into the service book.
- Returns:
- True if the record is dirty; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getHomeAddress
public String getHomeAddress()
- Retrieves this record's home address.
- Returns:
- This record's home address.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getDisabledState
public boolean getDisabledState()
- Determines this record's disabled state.
- Returns:
- True if the record is disabled; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getSource
public int getSource()
- Retrieves this record's source type.
- Returns:
- Source type for this record.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getDataSourceId
public String getDataSourceId()
- Retrieves this record's data source ID.
- Returns:
- Data source ID for this record.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getUserId
public int getUserId()
- Retrieves this record's user ID.
- Returns:
- user ID for this record.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getBBRHosts
public String[] getBBRHosts()
- Retrieves list of BBR hosts for this record.
- Returns:
- BBR host list.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getBBRPorts
public int[] getBBRPorts()
- Retrieves list of BBR ports for this record.
- Returns:
- BBR port list.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
getTransport
public Transport getTransport()
- Retrieves this service record's associated transport object using this service record's CID.
Use this method to return the Transport object associated with this service record.
- Returns:
- The Transport associated with this service record. A null value is never returned.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
isDisabled
public boolean isDisabled()
- Determines if this record is disabled.
Use this method to determine if this record currently has routing
information (enabled) or not (disabled).
- Returns:
- True if this record has no routing information; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
isEncrypted
public boolean isEncrypted()
- Deprecated. as of 5.0.0, replaced by
ServiceRecord.isEncryptedService(), ServiceRecord.isSignedOrEncrypted()
- Determines if this record's associated service is an encrypted service.
- Returns:
- True if this service is an encrypted service; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.2.0
isSignedOrEncrypted
public boolean isSignedOrEncrypted()
- Determines if this record's associated service is a signed or encrypted service.
- Returns:
- True if this service is a signed or encrypted service; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 5.0.0
isEncryptedService
public boolean isEncryptedService()
- Determines if this record's associated service is an encrypted service.
- Returns:
- True if this service is an encrypted service; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 5.0.0
isSignedService
public boolean isSignedService()
- Determines if this record's associated service is a signed service.
- Returns:
- True if this service uses signing; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 5.0.0
isSecureService
public boolean isSecureService()
- Deprecated. as of 5.0.0, replaced by
ServiceRecord.isStrongSecureService()
- Determines if this record's associated service is secure.
- Returns:
- True if this service is secure; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
isStrongSecureService
public boolean isStrongSecureService()
- Determines if this record's associated service is strong secure.
A strong secure service uses an encryption/signing mode with keys
that were established via a secure channel.
- Returns:
- True if this service is strong secure; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 5.0.0
isWeakSecureService
public boolean isWeakSecureService()
- Determines if this record's associated service is weakly secure.
A weak secure service uses an encryption mode with keys that were
established via an insecure channel.
- Returns:
- True if this service is weak secure; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.2.0
isInsecureService
public boolean isInsecureService()
- Determines if this record's associated service is insecure.
An insecure service uses no encryption mode for securing traffic.
- Returns:
- True if this service use no encryption; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 5.0.0
isRestoreDisabled
public boolean isRestoreDisabled()
- Determines if this record is disabled for backup/restore
- Returns:
- True if this service is explicitly disabled for restore
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.1.0
isRestoreEnabled
public boolean isRestoreEnabled()
- Determines if this record is disabled for backup/restore
- Returns:
- True if this service is explicitly enabled for restore
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.1.0
isInvisible
public boolean isInvisible()
- Determines if this record should be visible to the end user.
- Returns:
- True if this record is not visible to the end user in the Options->Service Book screen.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.2.0
getKeyHashForService
public int getKeyHashForService()
- getHashCodeForService.
Get the hash code for a serviceRecord.
- Returns:
- hash code for the key fields UID, CID, and User ID
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.1.0
copyInto
public void copyInto(ServiceRecord sr)
- Copies the data from this service record into another.
Note: This is not the same as cloning the service
record as many of the internal data members are shared between the
objects. Note that the record's ID is not copied.
- Parameters:
sr - Service record to contain the copied data; during the copy
process this passed service record also gets marked as dirty.- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
isDuplicate
public boolean isDuplicate(ServiceRecord rec,
int newType,
String newName,
String newUid,
String newCid,
String newDataSourceId,
int newUserId)
- Determines if the specified record is a duplicate of this record.
It is possible to indicate a different type, name, UID and CID to use
during the check. This way the calling code can determine if a change
will create a duplicate record before actually making the change.
Two records are considered duplicates if they have the same CID,
either the same name or the same UID and equivalent types. The types are
considered equivalent if they have the same SRT_ value or if the argument
record has type ServiceRecord.SRT_ACTIVE and the potential duplicate has a
type of either ServiceRecord.SRT_ACTIVE or ServiceRecord.SRT_OBSOLETE.
Note that UIDs and CIDs are case insensitive.
- Parameters:
rec - Record to match against.newType - The type to use for the provided record or ServiceRecord.SRT_NO_CHANGE
to use what the record currently contains.newName - The name to use for the provided record or null to use what
the record currently contains.newUid - The UID to use for the provided record or null to use what
the record currently contains.newCid - The CID to use for the provided record or null to use what
the record currently contains.dataSourceId - The data-source ID to use for the provided record or null
to use what the record currently contains.
- Returns:
- True if the argument record is a duplicate of this record;
otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
isDuplicate
public boolean isDuplicate(ServiceRecord rec,
int newType,
String newName,
String newUid,
String newCid,
String newDataSourceId,
int newUserId,
String newUserIdentity,
String newSourceIdentity)
- Determines if the specified record is a duplicate of this record.
It is possible to indicate a different type, name, UID and CID to use
during the check. This way the calling code can determine if a change
will create a duplicate record before actually making the change.
Two records are considered duplicates if they have the same CID,
either the same name or the same UID and equivalent types. The types are
considered equivalent if they have the same SRT_ value or if the argument
record has type ServiceRecord.SRT_ACTIVE and the potential duplicate has a
type of either ServiceRecord.SRT_ACTIVE or ServiceRecord.SRT_OBSOLETE.
Note that UIDs and CIDs are case insensitive.
- Parameters:
rec - Record to match against.newType - The type to use for the provided record or ServiceRecord.SRT_NO_CHANGE
to use what the record currently contains.newName - The name to use for the provided record or null to use what
the record currently contains.newUid - The UID to use for the provided record or null to use what
the record currently contains.newCid - The CID to use for the provided record or null to use what
the record currently contains.dataSourceId - The data-source ID to use for the provided record or null
to use what the record currently contains.newUserIdentity - Globally unique and immutable identity that defines the user
within a particular service.newSourceIdentity - Globally unique and immutable identity that defines the account
within a service.
- Returns:
- True if the argument record is a duplicate of this record;
otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 7.1.0
isValid
public boolean isValid()
- Determines if this record is valid.
A service record is valid if it has a name, UID, and CID. None of
which can have a length of zero.
- Returns:
- True if this record is valid; otherwise, false.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.0.0
toString
public String toString()
- toString implementation
- Overrides:
toString in class Object
- Returns:
- Returns the datasource ID and user ID if present, else the UID/Name Strings.
- Category:
- Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.
- Since:
- BlackBerry API 4.2.0
Copyright 1999-2011 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Java is a trademark of Oracle America Inc. in the US and other countries.
Legal