net.rim.device.api.servicebook
Class ServiceRecord

java.lang.Object
  extended by net.rim.device.api.servicebook.ServiceRecord
All Implemented Interfaces:
Persistable, 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
Category: Signed static int CDMA_WIRELESS_NET_TYPE
          CDMA Network.
Category: Signed static int COMPRESS_NONE
          Indicates no compression mode.
Category: Signed static int COMPRESS_RIM
          Indicates RIM-proprietary compression mode.
Category: Signed static int ENCRYPTED_ENCRYPTION_MODES
          Indicates the encryption modes that are considered encrypted.
Category: Signed static int ENCRYPT_NONE
          Indicates no encryption mode.
Category: Signed static int ENCRYPT_RIM
          Indicates RIM encryption (3DES or AES) Note: This is the default encryption mode.
Category: Signed static int ENCRYPT_RIM_SIGNED
          Indicates RIM BIS signing (HMAC-SHA256)
Category: Signed 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.
Category: Signed static int GPRS_WIRELESS_NET_TYPE
          GPRS Network.
Category: Signed static int IDEN_WIRELESS_NET_TYPE
          IDEN Network
Category: Signed static int INVALID_COMPRESSION_MODES
          Indicates an invalid compression mode.
Category: Signed static int INVALID_ENCRYPTION_MODES
          Indicates an invalid encryption mode.
Category: Signed static int INVALID_RECORD_ID
          Indicates an invalid record ID.
Category: Signed static int INVALID_USER_ID
          Indicates an invalid user ID.
Category: Signed static int MAJOR_VERSION
          Current major version of the ServiceRecords/ServiceBook.
Category: Signed static int MINOR_VERSION
          Current minor version of the ServiceRecord/ServiceBook.
Category: Signed static int MOBITEX_WIRELESS_NET_TYPE
          Deprecated. Mobitex is no longer supported.
Category: Signed static int NUM_SOURCES
          Indicates the total number of record source types.
Category: Signed static int SECURED_ENCRYPTION_MODES
          Indicates the encryption modes that are considered secured.
Category: Signed static int SOURCE_CODE
          Type indicates the record's source was programmatic.
Category: Signed static int SOURCE_EDITOR
          Type indicates the record's source was the SB Editor (user operated or otherwise).
Category: Signed static int SOURCE_OTA
          Type indicates the record's source was over the air.
Category: Signed static int SOURCE_OTA_SECURE
          Type indicates the record's source was a secure over-the-air connection.
Category: Signed static int SOURCE_SERIAL
          Type indicates the record's source was a serial link.
Category: Signed static int SOURCE_UNKNOWN
          Type indicates an unknown source.
Category: Signed static int SRT_ACTIVE
          Type indicates a service record that's in use.
Category: Signed static int SRT_DISALLOWED
          Type indicates a record disallowed by local IT Policy.
Category: Signed static int SRT_GHOST
          Type indicates a record deleted but sill recoverable.
Category: Signed static int SRT_NO_CHANGE
          Indicates service record type will not change.
Category: Signed static int SRT_NUM_TYPES
          Indicates the number of different service record types.
Category: Signed static int SRT_OBSOLETE
          Type indicates a record with an old version (0x00).
Category: Signed static int SRT_ORPHAN
          Type indicates a record usable but not in the service book.
Category: Signed static int SRT_PENDING
          Type indicates a record received but not yet accepted (or rejected).
Category: Signed static int SRT_UNKNOWN
          Type of service record is unknown.
Category: Signed static int VERSION
          Current version of the ServiceRecord/ServiceBook.
 
Constructor Summary
Category: Signed ServiceRecord()
          Creates a new service record instance, setting up initial values.
Category: Signed ServiceRecord(int source)
          Constructs a new service record from the given source.
 
Method Summary
Category: Signed  void copyInto(ServiceRecord sr)
          Copies the data from this service record into another.
Category: Signed  String getAPN()
          Retrieves this record's associated access point name.
Category: Signed  byte[] getApplicationData()
          Retrieves this service record's application-specific data.
Category: Signed  String[] getBBRHosts()
          Retrieves list of BBR hosts for this record.
Category: Signed  int[] getBBRPorts()
          Retrieves list of BBR ports for this record.
Category: Signed  String getCAAddress()
          Retrieves the address for this record's associated certificate authority.
Category: Signed  short getCAPort()
          Retrieves the port for this record's associated certificate authority.
Category: Signed  String getCARealm()
          Retrieves this record's associated certificate authority.
Category: Signed  String getCid()
          Retrieves this service record's CID.
Category: Signed  int getCidHash()
          Retrieves this service record's hashed CID (SHA-1 hash).
Category: Signed  int getCompressionMode()
          Retrieves server's available compression mode.
Category: Signed  String getDataSourceId()
          Retrieves this record's data source ID.
Category: Signed  String getDescription()
          Retrieves the textual description of this record.
Category: Signed  boolean getDisabledState()
          Determines this record's disabled state.
Category: Signed  int getEncryptionMode()
          Retrieves server's available encryption mode.
Category: Signed  String getHomeAddress()
          Retrieves this record's home address.
Category: Signed  int getId()
          Retrieves this service record's ID.
Category: Signed  int getKeyHashForService()
          getHashCodeForService.
Category: Signed  long getLastUpdated()
          Retrieves time this record was last updated
Category: Signed  String getName()
          Retrieves this service record's name.
Category: Signed  int getNameHash()
          Returns this service record's hashed name (SHA-1 hash).
Category: Signed  String getNetworkAddress()
          Retrieves this record's associated network address.
Category: Signed  int getNetworkType()
          Retrieves this record's associated network type.
Category: Signed  short getServiceIdentifierSubType()
          Retrieves the Service Identifier Sub Type
Category: Signed  short getServiceIdentifierType()
          Retrieves the service Identifier Type
Category: Signed  int getSource()
          Retrieves this record's source type.
Category: Signed  Transport getTransport()
          Retrieves this service record's associated transport object using this service record's CID.
Category: Signed  int getType()
          Retrieves this service record's type.
Category: Signed  String getUid()
          Retrieves this service record's UID.
Category: Signed  int getUidHash()
          Retrieves this service record's hashed UID (SHA-1 hash).
Category: Signed  int getUserId()
          Retrieves this record's user ID.
Category: Signed  boolean isDirty()
          Determines if this record has unsaved changes.
Category: Signed  boolean isDisabled()
          Determines if this record is disabled.
Category: Signed  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.
Category: Signed  boolean isEncrypted()
          Deprecated. as of 5.0.0, replaced by ServiceRecord.isEncryptedService(), ServiceRecord.isSignedOrEncrypted()
Category: Signed  boolean isEncryptedService()
          Determines if this record's associated service is an encrypted service.
Category: Signed  boolean isInsecureService()
          Determines if this record's associated service is insecure.
Category: Signed  boolean isInvisible()
          Determines if this record should be visible to the end user.
Category: Signed  boolean isRecordProtected()
          Determines if this record is protected.
Category: Signed  boolean isRestoreDisabled()
          Determines if this record is disabled for backup/restore
Category: Signed  boolean isRestoreEnabled()
          Determines if this record is disabled for backup/restore
Category: Signed  boolean isRestoredFromBackup()
          Determines if this record was restored from a backup
Category: Signed  boolean isSecureService()
          Deprecated. as of 5.0.0, replaced by ServiceRecord.isStrongSecureService()
Category: Signed  boolean isSignedOrEncrypted()
          Determines if this record's associated service is a signed or encrypted service.
Category: Signed  boolean isSignedService()
          Determines if this record's associated service is a signed service.
Category: Signed  boolean isStrongSecureService()
          Determines if this record's associated service is strong secure.
Category: Signed  boolean isValid()
          Determines if this record is valid.
Category: Signed  boolean isWeakSecureService()
          Determines if this record's associated service is weakly secure.
Category: Signed  String toString()
          toString implementation
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, wait, wait, wait
 



Field Detail

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


Constructor Detail

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


Method Detail

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.
See Also:
ServiceRecord.setType(int)
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

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-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.