com.helger.commons.messagedigest

Class NonBlockingMessageDigestGenerator

java.lang.Object

com.helger.commons.messagedigest.AbstractMessageDigestGenerator

com.helger.commons.messagedigest.NonBlockingMessageDigestGenerator

All Implemented Interfaces:

IMessageDigestGenerator

@NotThreadSafe
public final class NonBlockingMessageDigestGenerator
extends AbstractMessageDigestGenerator

Base class for creating a cryptographic hash value. Don't mix it up with the HashCodeGenerator which is used to generate hash values for Java objects.

Author:

Philip Helger

Field Summary

Fields inherited from interface com.helger.commons.messagedigest.IMessageDigestGenerator

DEFAULT_ALGORITHM

Constructor Summary

Constructors

Constructor and Description
NonBlockingMessageDigestGenerator() Create a default hash generator with the default algorithm.
NonBlockingMessageDigestGenerator(EMessageDigestAlgorithm... aAlgorithms) Create a hash generator with a set of possible algorithms to use.
NonBlockingMessageDigestGenerator(String sProvider) Create a default hash generator with the default algorithm and the specified security provider
NonBlockingMessageDigestGenerator(String sProvider, EMessageDigestAlgorithm... aAlgorithms) Create a hash generator with a set of possible algorithms to use.

Method Summary

Methods

Modifier and Type	Method and Description
String	getAlgorithmName()
byte[]	getAllDigestBytes() Finish calculation of the hash value and return the digest.
byte[]	getAllDigestBytes(int nLength) Get only a part of the digest, namely the first number of bytes.
int	getDigestLength()
Provider	getSecurityProvider()
void	reset() Reset the current hash so that generation can start from scratch again.
String	toString()
IMessageDigestGenerator	update(byte aValue) Update the hash with the given byte.
IMessageDigestGenerator	update(byte[] aValue, int nOfs, int nLen) Update the hash with a slice of the given byte array.

Methods inherited from class com.helger.commons.messagedigest.AbstractMessageDigestGenerator

getDigestHexString, getDigestLong, update, update

Methods inherited from class java.lang.Object

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

Constructor Detail

NonBlockingMessageDigestGenerator

public NonBlockingMessageDigestGenerator()

Create a default hash generator with the default algorithm.

NonBlockingMessageDigestGenerator

public NonBlockingMessageDigestGenerator(@Nullable
                                 String sProvider)

Create a default hash generator with the default algorithm and the specified security provider

Parameters:

sProvider - Security provider to be used. May be null to indicate the default.

NonBlockingMessageDigestGenerator

public NonBlockingMessageDigestGenerator(@Nonnull@Nonempty
                                 EMessageDigestAlgorithm... aAlgorithms)

Create a hash generator with a set of possible algorithms to use.

Parameters:

aAlgorithms - The parameters to test. May not be null.

Throws:

NullPointerException - If the array of algorithms is null or if one element of the array is null.

IllegalArgumentException - If no algorithm was passed or if no applicable algorithm was used.

NonBlockingMessageDigestGenerator

public NonBlockingMessageDigestGenerator(@Nullable
                                 String sProvider,
                                 @Nonnull@Nonempty
                                 EMessageDigestAlgorithm... aAlgorithms)

Create a hash generator with a set of possible algorithms to use.

Parameters:

sProvider - Security provider to be used. May be null to indicate the default.

aAlgorithms - The parameters to test. May not be null.

Throws:

NullPointerException - If the array of algorithms is null or if one element of the array is null.

IllegalArgumentException - If no algorithm was passed or if no applicable algorithm was used.

Method Detail

getSecurityProvider

@Nonnull
public Provider getSecurityProvider()

Returns:

The used security Provider. Should not be null.

getAlgorithmName

@Nonnull
public String getAlgorithmName()

Returns:

The name of the hashing algorithm used.

getDigestLength

@Nonnegative
public int getDigestLength()

Returns:

Returns the length of the digest in bytes, or 0 if this operation is not supported by the provider.

update

@Nonnull
public IMessageDigestGenerator update(byte aValue)

Description copied from interface: IMessageDigestGenerator

Update the hash with the given byte. After calling IMessageDigestGenerator.getAllDigestBytes() once, no further update is possible.

Parameters:

aValue - The byte value to update the hash

Returns:

this

update

@Nonnull
public IMessageDigestGenerator update(@Nonnull
                                     byte[] aValue,
                                     @Nonnegative
                                     int nOfs,
                                     @Nonnegative
                                     int nLen)

Description copied from interface: IMessageDigestGenerator

Update the hash with a slice of the given byte array. After calling IMessageDigestGenerator.getAllDigestBytes() once, no further update is possible.

Parameters:

aValue - The byte array to update the hash. May not be null.

nOfs - The offset within the byte array from which the value should be taken. May not be < 0.

nLen - The number of bytes to use, starting from the passed offset. May not be < 0.

Returns:

this

reset

public void reset()

Description copied from interface: IMessageDigestGenerator

Reset the current hash so that generation can start from scratch again.

getAllDigestBytes

@Nonnull
@ReturnsMutableCopy
public byte[] getAllDigestBytes()

Description copied from interface: IMessageDigestGenerator

Finish calculation of the hash value and return the digest. Afterwards no update is possible before IMessageDigestGenerator.reset() is called.

Returns:

A copy of the array with the message digest.

getAllDigestBytes

@Nonnull
@ReturnsMutableCopy
public byte[] getAllDigestBytes(@Nonnegative
                                                  int nLength)

Description copied from interface: IMessageDigestGenerator

Get only a part of the digest, namely the first number of bytes. Calls IMessageDigestGenerator.getAllDigestBytes() internally so no further update is possible after this method is called.

Parameters:

nLength - The number of bytes to be retrieved. Must be > 0.

Returns:

A copy of the first n bytes of the message digest array.

toString

public String toString()

Overrides:

toString in class Object