SHOW Signed

net.rim.device.api.crypto
Interface SignatureVerifier

All Known Implementing Classes:
X931SignatureVerifier, PSSSignatureVerifier, PKCS1SignatureVerifier, NullSignatureVerifier, ECNRSignatureVerifier, ECDSASignatureVerifier, DSASignatureVerifier

public interface SignatureVerifier

Defines the functions that are required for use with all of the signature verifiers that are implemented in the system.

A more complete description of what each function should perform can be found at the class level for each implementing class.

Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

Since:
JDE 3.6.0

Method Summary
 Category: Signed  String getAlgorithm()
          Returns the name of the signing algorithm used, eg "DSA", "ECDSA", etc.
 Category: Signed  void update(byte[] data)
          Adds additional message data to the signature.
 Category: Signed  void update(byte[] data, int offset, int length)
          Adds additional message data to the signature.
 Category: Signed  void update(int data)
          Adds additional message data to the signature.
 Category: Signed  boolean verify()
          Returns true if the signature is valid, false otherwise.
 

Method Detail

getAlgorithm

public String getAlgorithm()
Returns the name of the signing algorithm used, eg "DSA", "ECDSA", etc.

Returns:
A String representing the name of the algorithm.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

update

public void update(int data)
Adds additional message data to the signature.

Parameters:
data - The byte to be hashed.
Since:
JDE 4.0.2
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

update

public void update(byte[] data)
Adds additional message data to the signature.

Parameters:
data - A byte array containing the message data to hash.
Since:
JDE 4.0.2
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

update

public void update(byte[] data,
                   int offset,
                   int length)
Adds additional message data to the signature.

Parameters:
data - The message data to hash.
offset - The offset, or initial position to start reading in the data.
length - The amount of data to read.
Since:
JDE 4.0.2
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.

verify

public boolean verify()
               throws CryptoTokenException,
                      CryptoUnsupportedOperationException
Returns true if the signature is valid, false otherwise.

Returns:
A boolean that returns true if the signature is valid, false otherwise.
Throws:
CryptoTokenException - Thrown when a problem occurs with a crypto token or the crypto token is invalid.
CryptoUnsupportedOperationException - Thrown when a call is made to an unsupported operation.
Since:
JDE 3.6.0
Category:
Signed: This element is only accessible by signed clients. If you intend to use this element, please contact RIM to establish the necessary agreements that will allow you to have your COD files signed. Signing is only required for use on the device, development under the JDE can occur without signing the CODs.


Copyright 1999-2004 Research In Motion Limited. 295 Phillip Street, Waterloo, Ontario, Canada, N2L 3W8. All Rights Reserved.
Copyright 1993-2003 Sun Microsystems, Inc. 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.