net.rim.device.api.crypto
Interface BlockDecryptorEngine

All Known Subinterfaces:
BlockDecryptorEngineExt, PrivateKeyDecryptorEngine, SymmetricKeyDecryptorEngine
All Known Implementing Classes:
AESCBCDecryptorEngine, AESDecryptorEngine, CAST128DecryptorEngine, CBCDecryptorEngine, DESDecryptorEngine, ElGamalDecryptorEngine, RC2DecryptorEngine, RC5DecryptorEngine, RSADecryptorEngine, SkipjackDecryptorEngine, TripleDESCBCDecryptorEngine, TripleDESDecryptorEngine, XDecryptorEngine

public interface BlockDecryptorEngine

The BlockDecryptorEngine interface describes the functionality of using a block cipher for decryption.

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
Category: Signed  void decrypt(byte[] ciphertext, int ciphertextOffset, byte[] plaintext, int plaintextOffset)
          Decodes a block of the given ciphertext into a block of plaintext.
Category: Signed  String getAlgorithm()
          Returns the name of this algorithm, eg "DES".
Category: Signed  int getBlockLength()
          Returns the block length of the block cipher in bytes.
 



Method Detail

decrypt

void decrypt(byte[] ciphertext,
             int ciphertextOffset,
             byte[] plaintext,
             int plaintextOffset)
             throws CryptoTokenException
Decodes a block of the given ciphertext into a block of plaintext.

Parameters:
ciphertext - A byte array containing the input that is to be decrypted.
ciphertextOffset - The starting offset, or initial byte position, of the data within the input array.
plaintext - A byte array containing the output from the method.
plaintextOffset - The starting offset, or initial byte position, of the data within the output array.
Throws:
CryptoTokenException - Thrown when an error occurs with the crypto token or the crypto token is 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 3.6.0

getBlockLength

int getBlockLength()
Returns the block length of the block cipher in bytes.

Returns:
An integer that specifies the length of a block of data.
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

String getAlgorithm()
Returns the name of this algorithm, eg "DES". The general form of the algorithm is:
"<cipher name>[_<keyBitLength>[_<blockBitLength>[_<numberOfRounds>]]][/<mode>[/<padding>]]"

Returns:
A String representing 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





Copyright 1999-2010 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. All Rights Reserved.
Copyright 2002-2003 Nokia Corporation All Rights Reserved.
Java is a trademark of Sun Microsystems, Inc.