net.rim.device.api.crypto
Interface SignatureSigner

All Known Implementing Classes:

DSASignatureSigner, ECDSASignatureSigner, ECNRSignatureSigner, NullSignatureSigner, PKCS1SignatureSigner, PSSSignatureSigner, X931SignatureSigner

public interface SignatureSigner

Defines the methods required for each signing class that provides a signature engine. The methods will provide the necessary functionality for all signing applications. More information on the specific methods can be found in the implementing classes.

See SignatureSignerFactory to create a SignatureSigner.

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 3.6.0

Method Summary
	String	getAlgorithm() Returns the name of the signing algorithm used, eg "DSA", "ECDSA", etc.
	String	getDigestAlgorithm() Returns the name of the digest algorithm used, eg "SHA1", etc.
	void	reset() Reinitializes the signer, preparing it to generate another signature.
	void	update(byte[] data) Adds additional message data to the signature.
	void	update(byte[] data, int offset, int length) Adds additional message data to the signature.
	void	update(int data) Adds additional message data to the signature.

Method Detail

getAlgorithm

String getAlgorithm()

Returns the name of the signing algorithm used, eg "DSA", "ECDSA", etc.

Returns:

A String that represents the name of the algorithm.

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 3.6.0

getDigestAlgorithm

String getDigestAlgorithm()

Returns the name of the digest algorithm used, eg "SHA1", etc.

Returns:

A String that represents the name of the algorithm.

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 3.6.0

reset

void reset()

Reinitializes the signer, preparing it to generate another signature.

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 3.6.0

update

void update(int data)

Adds additional message data to the signature.

Parameters:

data - The byte to be hashed.

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 3.6.0

update

void update(byte[] data)

Adds additional message data to the signature.

Parameters:

data - The message data to hash.

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 3.6.0

update

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 the initial position to start reading in the data.

length - How much data to read.

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 3.6.0