io.puremetrics.sdk

Class MD5

java.lang.Object

java.security.MessageDigestSpi

java.security.MessageDigest

io.puremetrics.sdk.MD5

All Implemented Interfaces:

java.lang.Cloneable

public final class MD5
extends java.security.MessageDigest
implements java.lang.Cloneable

The MD5 message-digest algorithm takes as input a message of arbitrary length and produces as output a 128-bit "fingerprint" or "message digest" of the input. It is conjectured that it is computationally infeasible to produce two messages having the same message digest, or to produce any message having a given prespecified target message digest.

References:

1. Rivest R., "The MD5 Message-Digest Algorithm", Informational RFC 1321, MIT Laboratory for Computer Science, and RSA Data Security, Inc., April 1992.
2. RFC Editor, "Erratum for RFC 1321", 2002-06-14, 2001-01-19, 2000-04-12.

Constructor Summary

Constructors

Constructor and Description
MD5() Creates a MD5 object with default initial state.

Method Summary

Modifier and Type	Method and Description
java.lang.Object	clone() Clones this object.
byte[]	engineDigest() Completes the hash computation by performing final operations such as padding.
int	engineDigest(byte[] hashvalue, int offset, int length) Completes the hash computation by performing final operations such as padding.
int	engineGetDigestLength() Returns the digest length in bytes.
void	engineReset() Reset then initialize the digest context.
void	engineUpdate(byte input) Updates the digest using the specified byte.
void	engineUpdate(byte[] input, int offset, int length) Updates the digest using the specified array of bytes, starting at the specified offset. Input length can be any size.
protected void	init() Initialize the digest context.

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

engineUpdate

Methods inherited from class java.lang.Object

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

Constructor Detail

MD5

public MD5()

Creates a MD5 object with default initial state.

Method Detail

clone

public java.lang.Object clone()
                       throws java.lang.CloneNotSupportedException

Clones this object.

Overrides:

clone in class java.security.MessageDigest

Throws:

java.lang.CloneNotSupportedException

engineReset

public void engineReset()

Reset then initialize the digest context.

Overrides the protected abstract method of

java.security.MessageDigestSpi.

Specified by:

engineReset in class java.security.MessageDigestSpi

init

protected void init()

Initialize the digest context.

engineUpdate

public void engineUpdate(byte input)

Updates the digest using the specified byte. Requires internal buffering, and may be slow.

Overrides the protected abstract method of

java.security.MessageDigestSpi.

Specified by:

engineUpdate in class java.security.MessageDigestSpi

Parameters:

input - the byte to use for the update.

engineUpdate

public void engineUpdate(byte[] input,
                         int offset,
                         int length)

Updates the digest using the specified array of bytes, starting at the specified offset.

Input length can be any size. May require internal buffering, if input blocks are not multiple of 64 bytes.

Overrides the protected abstract method of java.security.MessageDigestSpi.

Specified by:

engineUpdate in class java.security.MessageDigestSpi

Parameters:

input - the array of bytes to use for the update.

offset - the offset to start from in the array of bytes.

length - the number of bytes to use, starting at offset.

engineDigest

public byte[] engineDigest()

Completes the hash computation by performing final operations such as padding. Computes the final hash and returns the final value as a byte[16] array. Once engineDigest has been called, the engine will be automatically reset as specified in the Java Security MessageDigest specification.

For faster operations with multiple digests, allocate your own array and use engineDigest(byte[], int offset, int len).

Overrides the protected abstract method of java.security.MessageDigestSpi.

Specified by:

engineDigest in class java.security.MessageDigestSpi

Returns:

the length of the digest stored in the output buffer.

engineGetDigestLength

public int engineGetDigestLength()

Returns the digest length in bytes. Can be used to allocate your own output buffer when computing multiple digests.

Overrides the protected abstract method of java.security.MessageDigestSpi.

Overrides:

engineGetDigestLength in class java.security.MessageDigestSpi

Returns:

the digest length in bytes.

engineDigest

public int engineDigest(byte[] hashvalue,
                        int offset,
                        int length)
                 throws java.security.DigestException

Completes the hash computation by performing final operations such as padding. Once engineDigest has been called, the engine will be automatically reset (see engineReset).

Overrides the protected abstract method of java.security.MessageDigestSpi.

Overrides:

engineDigest in class java.security.MessageDigestSpi

Parameters:

hashvalue - the output buffer in which to store the digest.

offset - offset to start from in the output buffer

length - number of bytes within buf allotted for the digest. Both this default implementation and the SUN provider do not return partial digests. The presence of this parameter is solely for consistency in our API's. If the value of this parameter is less than the actual digest length, the method will throw a DigestException. This parameter is ignored if its value is greater than or equal to the actual digest length.

Returns:

the length of the digest stored in the output buffer.

Throws:

java.security.DigestException