net.rim.device.api.crypto.encoder
Class DecodedSignature

java.lang.Object
  net.rim.device.api.crypto.encoder.DecodedSignature

public abstract class DecodedSignature
extends Object

Stores decoded signatures.

To verify a signature, call getVerifier to get access to the signature verifier.

See Also:

SignatureDecoder, EncodedSignature, SignatureEncoder

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

Constructor Summary
	protected	DecodedSignature()

Method Summary
	abstract String	getAlgorithm() Returns a string representing the signature algorithm in this decoded signature
	abstract SignatureVerifier	getVerifier(PublicKey publicKey) Returns a formatted signature verifier using the key passed in.
	abstract void	initialize(Digest digest) Initalizes the digest.

Methods inherited from class java.lang.Object

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

Constructor Detail

DecodedSignature

protected DecodedSignature()

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 Detail

initialize

public abstract void initialize(Digest digest)

Initalizes the digest.

The digest can have state information in it.

Parameters:

digest - The digest to use with the 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

getVerifier

public abstract SignatureVerifier getVerifier(PublicKey publicKey)
                                       throws CryptoTokenException,
                                              CryptoUnsupportedOperationException,
                                              InvalidSignatureEncodingException

Returns a formatted signature verifier using the key passed in.

Parameters:

publicKey - A public key to verify with.

Returns:

A signature verifier.

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.

InvalidSignatureEncodingException

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

getAlgorithm

public abstract String getAlgorithm()

Returns a string representing the signature algorithm in this decoded signature

Returns:

A string representing the signature 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