iaik.utils

Class PretendedMessageDigest

java.lang.Object

java.security.MessageDigestSpi

java.security.MessageDigest

iaik.utils.PretendedMessageDigest

All Implemented Interfaces:

java.lang.Cloneable

public class PretendedMessageDigest
extends java.security.MessageDigest
implements java.lang.Cloneable

This class pretends to be a MessageDigest engine.

This class does not actually compute a message digest value. Calling one of the update methods only will write the supplied data to a internal buffer. Calling the final digest method only will return the contents of this buffer; no digest computation ever has been performed.
Intended purpose of this class is to allow usage of MessageDigest engines with raw signature engines where the MessageDigest value already has been calculated outside the Signature engine and therefore no digest computation has to be done by the Signature engine's internal digest machine.

Since this class does not (cannot) know the hash algorithm actually used for hashing the data an application has to take care to provide a proper hash value when calling an update method; no check is (can be) performed if the supplied hash value corresponds to the hash algorithm in use (e.g. has the correct length).

Version:

File Revision 5

Constructor Summary

Constructors

Constructor and Description
PretendedMessageDigest() Default constructor.
PretendedMessageDigest(java.lang.String name, int digestLength) Creates a PretendedMessageDigest engine with given name and digest length.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	clone() Returns a clone of this object.
protected byte[]	engineDigest() Returns the final digest value.
int	engineGetDigestLength() SPI: Returns the length of the digest in bytes.
protected void	engineReset() Resets the buffer.
protected void	engineUpdate(byte input) SPI: Updates the internal buffer with the specified byte.
protected void	engineUpdate(byte[] input, int offset, int len) SPI: Updates the internal buffer with the specified number of bytes, beginning at the specified offset within the given byte array.

Methods inherited from class java.security.MessageDigest

digest, digest, digest, getAlgorithm, getDigestLength, getInstance, getInstance, getInstance, getProvider, isEqual, reset, toString, update, update, update, update

Methods inherited from class java.security.MessageDigestSpi

engineDigest, engineUpdate

Methods inherited from class java.lang.Object

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

Constructor Detail

PretendedMessageDigest

public PretendedMessageDigest()

Default constructor.

PretendedMessageDigest

public PretendedMessageDigest(java.lang.String name,
                      int digestLength)

Creates a PretendedMessageDigest engine with given name and digest length.

Parameters:

name - the name of the digest algorithm this class represents

digestLength - the length of the digest value produce by this engine

Method Detail

engineUpdate

protected final void engineUpdate(byte input)

SPI: Updates the internal buffer with the specified byte. No digest computation is performed.

Specified by:

engineUpdate in class java.security.MessageDigestSpi

Parameters:

input - the byte to be written to the internal buffer

Throws:

java.lang.IllegalArgumentException - if this engine has a defined digest size and the input data provided so far exceeds the digest size

engineUpdate

protected final void engineUpdate(byte[] input,
                int offset,
                int len)

SPI: Updates the internal buffer with the specified number of bytes, beginning at the specified offset within the given byte array. No digest computation is performed.

Specified by:

engineUpdate in class java.security.MessageDigestSpi

Parameters:

input - the byte array holding the data to be used for this update operation.

offset - the offset, indicating the start position within the given byte array.

len - the number of bytes to be obtained from the given byte array, starting at the given position.

Throws:

java.lang.IllegalArgumentException - if this engine has a defined digest size and the input data provided so far exceeds the digest size

engineDigest

protected byte[] engineDigest()

Returns the final digest value. This method only returns the contents of the internal buffer.

Specified by:

engineDigest in class java.security.MessageDigestSpi

engineGetDigestLength

public int engineGetDigestLength()

SPI: Returns the length of the digest in bytes. The value returned by this method only may represent the actual digest length when method digest already has been called. Otherwise this method may return 0.

Overrides:

engineGetDigestLength in class java.security.MessageDigestSpi

Returns:

the length of the digest in bytes.

engineReset

protected void engineReset()

Resets the buffer.

Specified by:

engineReset in class java.security.MessageDigestSpi

clone

public java.lang.Object clone()

Returns a clone of this object.

Overrides:

clone in class java.security.MessageDigest

Returns:

a clone of this pretended MessageDigest engine holding the current buffer state