org.bouncycastle.crypto.paddings

Class PaddedBufferedMultiBlockCipher

java.lang.Object

org.bouncycastle.crypto.DefaultBufferedMultiBlockCipher

org.bouncycastle.crypto.paddings.PaddedBufferedMultiBlockCipher

All Implemented Interfaces:

BufferedBlockCipher

public class PaddedBufferedMultiBlockCipher
extends DefaultBufferedMultiBlockCipher

A wrapper class that allows multi-block ciphers to be used to process data in a piecemeal fashion with padding. The PaddedBufferedMultiBlockCipher outputs a block only when the buffer is full and more data is being added, or on a doFinal (unless the current block in the buffer is a pad block). The default padding mechanism used is the one outlined in PKCS5/PKCS7.

Field Summary

Fields inherited from class org.bouncycastle.crypto.DefaultBufferedMultiBlockCipher

blockSize, buf, bufOff, cipher, forEncryption, partialBlockOkay, pgpCFB

Constructor Summary

Constructors

Constructor and Description
PaddedBufferedMultiBlockCipher(MultiBlockCipher cipher, BlockCipherPadding padding) Create a buffered block cipher with the desired padding.

Method Summary

Modifier and Type	Method and Description
int	doFinal(byte[] out, int outOff) Process the last block in the buffer.
int	getOutputSize(int len) return the minimum size of the output buffer required for an update plus a doFinal with an input of len bytes.
int	getUpdateOutputSize(int len) return the size of the output buffer required for an update an input of len bytes.
void	init(boolean forEncryption, CipherParameters params) initialise the cipher.
int	processByte(byte in, byte[] out, int outOff) process a single byte, producing an output block if neccessary.
int	processBytes(byte[] in, int inOff, int len, byte[] out, int outOff) process an array of bytes, producing output if necessary.

Methods inherited from class org.bouncycastle.crypto.DefaultBufferedMultiBlockCipher

getBlockSize, getUnderlyingCipher, reset, toString

Methods inherited from class java.lang.Object

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

Constructor Detail

PaddedBufferedMultiBlockCipher

public PaddedBufferedMultiBlockCipher(MultiBlockCipher cipher,
                                      BlockCipherPadding padding)

Create a buffered block cipher with the desired padding.

Parameters:

cipher - the underlying block cipher this buffering object wraps.

padding - the padding type.

Method Detail

init

public void init(boolean forEncryption,
                 CipherParameters params)
          throws java.lang.IllegalArgumentException

initialise the cipher.

Specified by:

init in interface BufferedBlockCipher

Overrides:

init in class DefaultBufferedMultiBlockCipher

Parameters:

forEncryption - if true the cipher is initialised for encryption, if false for decryption.

params - the key and other data required by the cipher.

Throws:

java.lang.IllegalArgumentException - if the params argument is inappropriate.

getOutputSize

public int getOutputSize(int len)

return the minimum size of the output buffer required for an update plus a doFinal with an input of len bytes.

Specified by:

getOutputSize in interface BufferedBlockCipher

Overrides:

getOutputSize in class DefaultBufferedMultiBlockCipher

Parameters:

len - the length of the input.

Returns:

the space required to accommodate a call to update and doFinal with len bytes of input.

getUpdateOutputSize

public int getUpdateOutputSize(int len)

return the size of the output buffer required for an update an input of len bytes.

Specified by:

getUpdateOutputSize in interface BufferedBlockCipher

Overrides:

getUpdateOutputSize in class DefaultBufferedMultiBlockCipher

Parameters:

len - the length of the input.

Returns:

the space required to accommodate a call to update with len bytes of input.

processByte

public int processByte(byte in,
                       byte[] out,
                       int outOff)
                throws DataLengthException,
                       java.lang.IllegalStateException

process a single byte, producing an output block if neccessary.

Specified by:

processByte in interface BufferedBlockCipher

Overrides:

processByte in class DefaultBufferedMultiBlockCipher

Parameters:

in - the input byte.

out - the space for any output that might be produced.

outOff - the offset from which the output will be copied.

Returns:

the number of output bytes copied to out.

Throws:

DataLengthException - if there isn't enough space in out.

java.lang.IllegalStateException - if the cipher isn't initialised.

processBytes

public int processBytes(byte[] in,
                        int inOff,
                        int len,
                        byte[] out,
                        int outOff)
                 throws DataLengthException,
                        java.lang.IllegalStateException

process an array of bytes, producing output if necessary.

Specified by:

processBytes in interface BufferedBlockCipher

Overrides:

processBytes in class DefaultBufferedMultiBlockCipher

Parameters:

in - the input byte array.

inOff - the offset at which the input data starts.

len - the number of bytes to be copied out of the input array.

out - the space for any output that might be produced.

outOff - the offset from which the output will be copied.

Returns:

the number of output bytes copied to out.

Throws:

DataLengthException - if there isn't enough space in out.

java.lang.IllegalStateException - if the cipher isn't initialised.

doFinal

public int doFinal(byte[] out,
                   int outOff)
            throws DataLengthException,
                   java.lang.IllegalStateException,
                   InvalidCipherTextException

Process the last block in the buffer. If the buffer is currently full and padding needs to be added a call to doFinal will produce 2 * getBlockSize() bytes.

Specified by:

doFinal in interface BufferedBlockCipher

Overrides:

doFinal in class DefaultBufferedMultiBlockCipher

Parameters:

out - the array the block currently being held is copied into.

outOff - the offset at which the copying starts.

Returns:

the number of output bytes copied to out.

Throws:

DataLengthException - if there is insufficient space in out for the output or we are decrypting and the input is not block size aligned.

java.lang.IllegalStateException - if the underlying cipher is not initialised.

InvalidCipherTextException - if padding is expected and not found.