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

java.lang.Object
  net.rim.device.api.crypto.encoder.SignatureDecoder
      net.rim.device.api.crypto.encoder.CMS_SignatureDecoder

public class CMS_SignatureDecoder
extends SignatureDecoder

Implements the signature decoder for CMS.

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

Constructor Summary
	CMS_SignatureDecoder() Creates a new CMS_SignatureDecoder object.

Method Summary
	protected DecodedSignature	decodeSignature(InputStream encodedSignature, String signatureAlgorithm, String digestAlgorithm) Decodes the input stream.
	protected DecodedSignature	decodeSignature(ASN1InputByteArray parameters, byte[] encodedSignature, String algorithm, String digestString) The function a subclass would implement to finish decoding the signature.
	protected String	getEncodingAlgorithm() Returns the encoding algorithm used, ie.
	protected String[]	getSignatureAlgorithms() Returns the signature algorithm used, such as "DSA", or "RSA_PKCS1_SHA1".

Methods inherited from class net.rim.device.api.crypto.encoder.SignatureDecoder

decode, decode, decode, decode, decode, getDecoder, register

Methods inherited from class java.lang.Object

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

Constructor Detail

CMS_SignatureDecoder

public CMS_SignatureDecoder()

Creates a new CMS_SignatureDecoder object.

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

Method Detail

decodeSignature

protected DecodedSignature decodeSignature(InputStream encodedSignature,
                                           String signatureAlgorithm,
                                           String digestAlgorithm)
                                    throws NoSuchAlgorithmException,
                                           InvalidSignatureEncodingException

Description copied from class: SignatureDecoder

Decodes the input stream.

Specified by:

decodeSignature in class SignatureDecoder

Parameters:

encodedSignature - An input stream containing the encoding.

signatureAlgorithm - The signature algorithm used.

Returns:

A DecodedSignature object from which a signature verifier can be obtained.

Throws:

NoSuchAlgorithmException - Thrown if the specified encoding algorithm cannot be found.

InvalidSignatureEncodingException - Thrown if the signature is incorrectly formatted.

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

decodeSignature

protected DecodedSignature decodeSignature(ASN1InputByteArray parameters,
                                           byte[] encodedSignature,
                                           String algorithm,
                                           String digestString)
                                    throws NoSuchAlgorithmException,
                                           InvalidSignatureEncodingException

The function a subclass would implement to finish decoding the signature.

Parameters:

parameters - The parameters that specify the details of the encoding.

encodedSignature - A byte array containing the encoded signature.

algorithm - A String representing the name of the algorithm used to encode the data.

digestString - A String representing any parameters required by the signature decoder. Often this is a digest. Can be null.

Returns:

The decoded signature.

Throws:

NoSuchAlgorithmException - Thrown if the specified algorithm is invalid.

InvalidSignatureEncodingException - Thrown if the signature is improperly formatted or invalid.

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

getEncodingAlgorithm

protected String getEncodingAlgorithm()

Returns the encoding algorithm used, ie. "CMS".

This method will always return the String "CMS".

Specified by:

getEncodingAlgorithm in class SignatureDecoder

Returns:

A String that represents the name of the encoding 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 4.1.0

getSignatureAlgorithms

protected String[] getSignatureAlgorithms()

Returns the signature algorithm used, such as "DSA", or "RSA_PKCS1_SHA1".

Specified by:

getSignatureAlgorithms in class SignatureDecoder

Returns:

An array of Strings representing the signature algorithms.

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