Package org.bouncycastle.jce.provider

Class JCEStreamCipher

java.lang.Object
javax.crypto.CipherSpi
org.bouncycastle.jce.provider.JCEStreamCipher
All Implemented Interfaces:
PBE
public class JCEStreamCipher
extends CipherSpi
implements PBE

  • Nested Class Summary

    Nested classes/interfaces inherited from interface org.bouncycastle.jcajce.provider.symmetric.util.PBE

    PBE.Util

  • Field Summary

    Fields inherited from interface org.bouncycastle.jcajce.provider.symmetric.util.PBE

    MD5, OPENSSL, PKCS12, PKCS5S1, PKCS5S1_UTF8, PKCS5S2, PKCS5S2_UTF8, SHA1, SHA256

  • Constructor Summary

    Constructors
    Modifier Constructor Description
    protected JCEStreamCipher​(BlockCipher engine, int ivLength)  
    protected JCEStreamCipher​(StreamCipher engine, int ivLength)  

  • Method Summary

    Modifier and Type Method Description
    protected byte[] engineDoFinal​(byte[] input, int inputOffset, int inputLen)
    Finishes a multi-part transformation (encryption or decryption).
    protected int engineDoFinal​(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset)
    Finishes a multi-part transformation (encryption or decryption).
    protected int engineGetBlockSize()
    Returns the block size of this cipher (in bytes)
    protected byte[] engineGetIV()
    Returns the Initialization Vector (IV) that was used to initialize this cipher or null if none was used.
    protected int engineGetKeySize​(Key key)
    Returns the size of a specified key object in bits.
    protected int engineGetOutputSize​(int inputLen)
    Returns the size for a buffer (in bytes), that the next call to update of doFinal would return, taking into account any buffered data from previous update calls and padding.
    protected AlgorithmParameters engineGetParameters()
    Returns the parameters that where used to create this cipher instance.
    protected void engineInit​(int opmode, Key key, AlgorithmParameters params, SecureRandom random)
    Initializes this cipher instance with the specified key, algorithm parameters and a source of randomness.
    protected void engineInit​(int opmode, Key key, SecureRandom random)
    Initializes this cipher instance with the specified key and a source of randomness.
    protected void engineInit​(int opmode, Key key, AlgorithmParameterSpec params, SecureRandom random)
    Initializes this cipher instance with the specified key, algorithm parameters and a source of randomness.
    protected void engineSetMode​(String mode)
    should never be called.
    protected void engineSetPadding​(String padding)
    should never be called.
    protected Key engineUnwrap​(byte[] wrappedKey, String wrappedKeyAlgorithm, int wrappedKeyType)
    Unwraps a key using this cipher instance.
    protected byte[] engineUpdate​(byte[] input, int inputOffset, int inputLen)
    Continues a multi-part transformation (encryption or decryption).
    protected int engineUpdate​(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset)
    Continues a multi-part transformation (encryption or decryption).
    protected byte[] engineWrap​(Key key)
    Wraps a key using this cipher instance.

    Methods inherited from class javax.crypto.CipherSpi

    engineDoFinal, engineUpdate, engineUpdateAAD, engineUpdateAAD

    Methods inherited from class java.lang.Object

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

  • Constructor Details

    • JCEStreamCipher

      protected JCEStreamCipher​(StreamCipher engine, int ivLength)

    • JCEStreamCipher

      protected JCEStreamCipher​(BlockCipher engine, int ivLength)

  • Method Details

    • engineGetBlockSize

      protected int engineGetBlockSize()
      Description copied from class: CipherSpi
      Returns the block size of this cipher (in bytes)
      Specified by:
      engineGetBlockSize in class CipherSpi
      Returns:
      the block size of this cipher, or zero if this cipher is not a block cipher.

    • engineGetIV

      protected byte[] engineGetIV()
      Description copied from class: CipherSpi
      Returns the Initialization Vector (IV) that was used to initialize this cipher or null if none was used.
      Specified by:
      engineGetIV in class CipherSpi
      Returns:
      the Initialization Vector (IV), or null if none was used.

    • engineGetKeySize

      protected int engineGetKeySize​(Key key)
      Description copied from class: CipherSpi
      Returns the size of a specified key object in bits. This method has been added to this class (for backwards compatibility, it cannot be abstract). If this method is not overridden, it throws an UnsupportedOperationException.
      Overrides:
      engineGetKeySize in class CipherSpi
      Parameters:
      key - the key to get the size for.
      Returns:
      the size of a specified key object in bits.

    • engineGetOutputSize

      protected int engineGetOutputSize​(int inputLen)
      Description copied from class: CipherSpi
      Returns the size for a buffer (in bytes), that the next call to update of doFinal would return, taking into account any buffered data from previous update calls and padding.

      The actual output length of the next call to update or doFinal may be smaller than the length returned by this method.

      Specified by:
      engineGetOutputSize in class CipherSpi
      Parameters:
      inputLen - the length of the input (in bytes).
      Returns:
      the size for a buffer (in bytes).

    • engineGetParameters

      protected AlgorithmParameters engineGetParameters()
      Description copied from class: CipherSpi
      Returns the parameters that where used to create this cipher instance.

      These may be a the same parameters that were used to create this cipher instance, or may be a combination of default and random parameters, depending on the underlying cipher implementation.

      Specified by:
      engineGetParameters in class CipherSpi
      Returns:
      the parameters that where used to create this cipher instance, or null if this cipher instance does not have any parameters at all.

    • engineSetMode

      protected void engineSetMode​(String mode)
      should never be called.
      Specified by:
      engineSetMode in class CipherSpi
      Parameters:
      mode - the name of the cipher mode.

    • engineSetPadding

      protected void engineSetPadding​(String padding) throws NoSuchPaddingException
      should never be called.
      Specified by:
      engineSetPadding in class CipherSpi
      Parameters:
      padding - the name of the padding method.
      Throws:
      NoSuchPaddingException - if the specified padding method is not supported by this cipher.

    • engineInit

      protected void engineInit​(int opmode, Key key, AlgorithmParameterSpec params, SecureRandom random) throws InvalidKeyException, InvalidAlgorithmParameterException
      Description copied from class: CipherSpi
      Initializes this cipher instance with the specified key, algorithm parameters and a source of randomness.

      The cipher will be initialized for the specified operation (one of: encryption, decryption, key wrapping or key unwrapping) depending on opmode.

      If this cipher instance needs any algorithm parameters and params is null, the underlying implementation of this cipher is supposed to generate the required parameters (using its provider or random values). Random values are generated using random.

      When a cipher instance is initialized by a call to any of the init methods, the state of the instance is overridden, means it is equivalent to creating a new instance and calling it init method.

      Specified by:
      engineInit in class CipherSpi
      Parameters:
      opmode - the operation this cipher instance should be initialized for (one of: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE or UNWRAP_MODE).
      key - the input key for the operation.
      params - the algorithm parameters.
      random - the source of randomness to use.
      Throws:
      InvalidKeyException - if the specified key cannot be used to initialize this cipher instance.
      InvalidAlgorithmParameterException - it the specified parameters are inappropriate for this cipher.

    • engineInit

      protected void engineInit​(int opmode, Key key, AlgorithmParameters params, SecureRandom random) throws InvalidKeyException, InvalidAlgorithmParameterException
      Description copied from class: CipherSpi
      Initializes this cipher instance with the specified key, algorithm parameters and a source of randomness.

      The cipher will be initialized for the specified operation (one of: encryption, decryption, key wrapping or key unwrapping) depending on opmode.

      If this cipher instance needs any algorithm parameters and params is null, the underlying implementation of this cipher is supposed to generate the required parameters (using its provider or random values). Random values are generated using random.

      When a cipher instance is initialized by a call to any of the init methods, the state of the instance is overridden, means it is equivalent to creating a new instance and calling it init method.

      Specified by:
      engineInit in class CipherSpi
      Parameters:
      opmode - the operation this cipher instance should be initialized for (one of: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE or UNWRAP_MODE).
      key - the input key for the operation.
      params - the algorithm parameters.
      random - the source of randomness to use.
      Throws:
      InvalidKeyException - if the specified key cannot be used to initialize this cipher instance.
      InvalidAlgorithmParameterException - if the specified parameters are inappropriate for this cipher.

    • engineInit

      protected void engineInit​(int opmode, Key key, SecureRandom random) throws InvalidKeyException
      Description copied from class: CipherSpi
      Initializes this cipher instance with the specified key and a source of randomness.

      The cipher will be initialized for the specified operation (one of: encryption, decryption, key wrapping or key unwrapping) depending on opmode.

      If this cipher instance needs any algorithm parameters or random values that the specified key cannot provide, the underlying implementation of this cipher is supposed to generate the required parameters (using its provider or random values). Random values will be generated using random;

      When a cipher instance is initialized by a call to any of the init methods, the state of the instance is overridden, means it is equivalent to creating a new instance and calling it init method.

      Specified by:
      engineInit in class CipherSpi
      Parameters:
      opmode - the operation this cipher instance should be initialized for (one of: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE or UNWRAP_MODE).
      key - the input key for the operation.
      random - the source of randomness to use.
      Throws:
      InvalidKeyException - if the specified key cannot be used to initialize this cipher instance.

    • engineUpdate

      protected byte[] engineUpdate​(byte[] input, int inputOffset, int inputLen)
      Description copied from class: CipherSpi
      Continues a multi-part transformation (encryption or decryption). The transformed bytes are returned.
      Specified by:
      engineUpdate in class CipherSpi
      Parameters:
      input - the input bytes to transform.
      inputOffset - the offset in the input to start.
      inputLen - the length of the input to transform.
      Returns:
      the transformed bytes in a new buffer, or null if the input has zero length.

    • engineUpdate

      protected int engineUpdate​(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset) throws ShortBufferException
      Description copied from class: CipherSpi
      Continues a multi-part transformation (encryption or decryption). The transformed bytes are stored in the output buffer.

      If the size of the output buffer is too small to hold the result, a ShortBufferException is thrown. Use getOutputSize to check for the size of the output buffer.

      Specified by:
      engineUpdate in class CipherSpi
      Parameters:
      input - the input bytes to transform.
      inputOffset - the offset in the input to start.
      inputLen - the length of the input to transform.
      output - the output buffer.
      outputOffset - the offset in the output buffer.
      Returns:
      the number of bytes placed in output.
      Throws:
      ShortBufferException - if the size of the output buffer is too small.

    • engineDoFinal

      protected byte[] engineDoFinal​(byte[] input, int inputOffset, int inputLen) throws BadPaddingException, IllegalBlockSizeException
      Description copied from class: CipherSpi
      Finishes a multi-part transformation (encryption or decryption).

      Processes the inputLen bytes in input buffer at inputOffset, and any bytes that have been buffered in previous update calls.

      Specified by:
      engineDoFinal in class CipherSpi
      Parameters:
      input - the input buffer.
      inputOffset - the offset in the input buffer.
      inputLen - the length of the input.
      Returns:
      the final bytes from the transformation.
      Throws:
      BadPaddingException - if the padding of the data does not match the padding scheme.
      IllegalBlockSizeException - if the size of the resulting bytes is not a multiple of the cipher block size.

    • engineDoFinal

      protected int engineDoFinal​(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset) throws BadPaddingException
      Description copied from class: CipherSpi
      Finishes a multi-part transformation (encryption or decryption).

      Processes the inputLen bytes in input buffer at inputOffset, and any bytes that have been buffered in previous update calls.

      Specified by:
      engineDoFinal in class CipherSpi
      Parameters:
      input - the input buffer.
      inputOffset - the offset in the input buffer.
      inputLen - the length of the input.
      output - the output buffer for the transformed bytes.
      outputOffset - the offset in the output buffer.
      Returns:
      the number of bytes placed in the output buffer.
      Throws:
      BadPaddingException - if the padding of the data does not match the padding scheme.

    • engineWrap

      protected byte[] engineWrap​(Key key) throws IllegalBlockSizeException, InvalidKeyException
      Description copied from class: CipherSpi
      Wraps a key using this cipher instance. This method has been added to this class (for backwards compatibility, it cannot be abstract). If this method is not overridden, it throws an UnsupportedOperationException.
      Overrides:
      engineWrap in class CipherSpi
      Parameters:
      key - the key to wrap.
      Returns:
      the wrapped key
      Throws:
      IllegalBlockSizeException - if the size of the resulting bytes is not a multiple of the cipher block size.
      InvalidKeyException - if this cipher instance cannot wrap this key.

    • engineUnwrap

      protected Key engineUnwrap​(byte[] wrappedKey, String wrappedKeyAlgorithm, int wrappedKeyType) throws InvalidKeyException
      Description copied from class: CipherSpi
      Unwraps a key using this cipher instance.

      This method has been added to this class (for backwards compatibility, it cannot be abstract). If this method is not overridden, it throws an UnsupportedOperationException.

      Overrides:
      engineUnwrap in class CipherSpi
      Parameters:
      wrappedKey - the wrapped key to unwrap.
      wrappedKeyAlgorithm - the algorithm for the wrapped key.
      wrappedKeyType - the type of the wrapped key (one of: SECRET_KEY, PRIVATE_KEY or PUBLIC_KEY)
      Returns:
      the unwrapped key.
      Throws:
      InvalidKeyException - if the wrappedKey cannot be unwrapped to a key of type wrappedKeyType for the wrappedKeyAlgorithm.