net.rim.device.api.system
Class CodeSigningKey

java.lang.Object
  |
  +--net.rim.device.api.system.CodeSigningKey

All Implemented Interfaces:

Persistable, net.rim.vm.Persistable

public final class CodeSigningKey

extends Object

implements Persistable

Provides access to code signing keys to facilitate run-time access checking.

Field Summary

static int	RBB_SIGNER_ID ID for the RIM BlackBerry signing authority.
static int	RCC_SIGNER_ID ID for the RIM Crypto Certicom signing authority.
static int	RCR_SIGNER_ID ID for the RIM Crypto Runtime signing authority.
static int	RRT_SIGNER_ID ID for the RIM Runtime signing authority.

Constructor Summary

CodeSigningKey(int signerId, byte[] publicKey, String description)
Creates new CodeSigningKey instance.

CodeSigningKey(String signerId, byte[] publicKey, String description)
Creates new CodeSigningKey instance.

Method Summary

static String	convert(int i) Retrieves string form of integer ID.
static int	convert(String s) Retrieves integer form of string ID
boolean	equals(Object obj) Determines whether provided object is equivalent to this code signing key.
static CodeSigningKey	get(int moduleHandle, int signerId) Retrieves code signing information associated with numeric signer ID.
static CodeSigningKey	get(int moduleHandle, String signerId) Retrieves code signing information associated with numeric signer ID.
static CodeSigningKey	get(Object obj) Retrieves code signing information for provided object.
String	getDescription() Retrieves description of Signing Authority.
byte[]	getPublicKey() Retrieves public key.
String	getSignerId() Retrieves signer's ID.
int	getSignerIdAsInt() Retrieves signer's ID as integer.

Methods inherited from class java.lang.Object

getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

RRT_SIGNER_ID

public static final int RRT_SIGNER_ID

ID for the RIM Runtime signing authority.

RCC_SIGNER_ID

public static final int RCC_SIGNER_ID

ID for the RIM Crypto Certicom signing authority.

RCR_SIGNER_ID

public static final int RCR_SIGNER_ID

ID for the RIM Crypto Runtime signing authority.

RBB_SIGNER_ID

public static final int RBB_SIGNER_ID

ID for the RIM BlackBerry signing authority.

Constructor Detail

CodeSigningKey

public CodeSigningKey(String signerId,
                      byte[] publicKey,
                      String description)

Creates new CodeSigningKey instance.

Parameters:

signerId - ID of the Signing Authority (typically this is the filename of the key file).

publicKey - Public key data.

description - Description or name of the Signing Authority.

CodeSigningKey

public CodeSigningKey(int signerId,
                      byte[] publicKey,
                      String description)

Creates new CodeSigningKey instance.

Parameters:

signerId - ID of the Signing Authority (you can find this value by looking at the properties of the key file).

publicKey - Public key data.

description - Description or name of the Signing Authority.

Method Detail

getSignerId

public String getSignerId()

Retrieves signer's ID.

Returns:

Signer's ID as a string.

getSignerIdAsInt

public int getSignerIdAsInt()

Retrieves signer's ID as integer.

Returns:

Signer's ID as an integer.

getPublicKey

public byte[] getPublicKey()

Retrieves public key.

Returns:

Public key data.

getDescription

public String getDescription()

Retrieves description of Signing Authority.

Returns:

Signing Authority description.

equals

public boolean equals(Object obj)

Determines whether provided object is equivalent to this code signing key.

Use this method to test whether a provided object is equal to this code signing key. This is true if and only if the signer IDs match, the public keys match, and the descriptions match.

Overrides:

equals in class Object

Parameters:

obj - Object to test against this one for equality.

Returns:

True if provided object is equivalent to this code signing key; otherwise, false.

Since:

JDE 3.6

get

public static CodeSigningKey get(Object obj)

Retrieves code signing information for provided object.

Parameters:

obj - Object for which to retrieve the code signing information.

Returns:

Code signing information for provided object, or null if no signing information exists for that object.

Since:

JDE 3.6

get

public static CodeSigningKey get(int moduleHandle,
                                 int signerId)

Retrieves code signing information associated with numeric signer ID.

Parameters:

moduleHandle - Handle to the code module containing the key information.

signerID - ID for code signer.

Returns:

Code signing information for provided signer ID, or null if no signing information exists for that signer.

Since:

JDE 3.6

get

public static CodeSigningKey get(int moduleHandle,
                                 String signerId)

Retrieves code signing information associated with numeric signer ID.

Parameters:

moduleHandle - Handle to the code module containing the key information.

signerID - ID for code signer.

Returns:

Code signing information for provided signer ID, or null if no signing information exists for that signer.

Since:

JDE 3.6

convert

public static int convert(String s)

Retrieves integer form of string ID

Parameters:

s - String form of a signer ID.

Returns:

Integer form of signer's ID.

Since:

JDE 3.6

convert

public static String convert(int i)

Retrieves string form of integer ID.

Parameters:

i - Integer form of a signer ID.

Returns:

String form of signer's ID.

Since:

JDE 3.6