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

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

public class WTLS_SignatureDecoder
extends SignatureDecoder

Implements the signature decoder for WTLS.

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
	WTLS_SignatureDecoder() Creates a new WTLS_SignatureDecoder object.

Method Summary
	protected DecodedSignature	decodeSignature(byte[] encodedSignature, String signatureAlgorithm, String digestAlgorithm) Decodes a signature.
	protected DecodedSignature	decodeSignature(InputStream encodedSignature, String signatureAlgorithm, String digestAlgorithm) Decodes the input stream.
	protected String	getEncodingAlgorithm() Returns the encoding algorithm used, such as "WTLS".
	protected String[]	getSignatureAlgorithms() Returns the signature algorithm used, such as "ECDSA", or "RSA".

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

WTLS_SignatureDecoder

public WTLS_SignatureDecoder()

Creates a new WTLS_SignatureDecoder object.

This is the default constructor.

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

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 3.6.0

decodeSignature

protected DecodedSignature decodeSignature(byte[] encodedSignature,
                                           String signatureAlgorithm,
                                           String digestAlgorithm)
                                    throws NoSuchAlgorithmException,
                                           InvalidSignatureEncodingException

Decodes a signature.

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

Parameters:

encodedSignature - A byte array containing the encoded signature.

signatureAlgorithm - A String representing the algorithm.

Returns:

The decoded signature.

Throws:

NoSuchAlgorithmException - Thrown if the specified algorithm cannot be found.

InvalidSignatureEncodingException - Thrown if the signature is formatted incorrectly.

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

getEncodingAlgorithm

protected String getEncodingAlgorithm()

Returns the encoding algorithm used, such as "WTLS".

Specified by:

getEncodingAlgorithm in class SignatureDecoder

Returns:

A String representing 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 3.6.0

getSignatureAlgorithms

protected String[] getSignatureAlgorithms()

Returns the signature algorithm used, such as "ECDSA", or "RSA".

Specified by:

getSignatureAlgorithms in class SignatureDecoder

Returns:

An array of Strings representing the names of all 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 3.6.0