com.safenetinc.luna.provider.digest

Class LunaDigest

java.lang.Object

java.security.MessageDigestSpi

com.safenetinc.luna.provider.digest.LunaDigest

Direct Known Subclasses:

LunaDigestMD2, LunaDigestSHA1, LunaDigestSHA224, LunaDigestSHA256, LunaDigestSHA3_224, LunaDigestSHA3_256, LunaDigestSHA3_384, LunaDigestSHA3_512, LunaDigestSHA384, LunaDigestSHA512, LunaDigestSM3

public abstract class LunaDigest
extends java.security.MessageDigestSpi

Abstract base class for the Luna provider's message digest engine classes. Digest engines that subclass from LunaDigest run the hash computations on the Luna HSM.

Field Summary

Fields

Modifier and Type	Field and Description
protected byte[]	mByteArray
protected long	mMechType

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	LunaDigest(long mechType) Creates a new LunaDigest using a PKCS11 mechanism type to specify the digest type.

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.Object	clone() Cloning is not supported for Luna message digests.
protected byte[]	engineDigest() Runs the hash computation on the accumulated data and returns the result in a new byte array.
protected int	engineDigest(byte[] output, int offset, int len) Runs the hash computation on the accumulated data and copies the result into the specified buffer.
protected abstract int	engineGetDigestLength() Returns the digest length in bytes.
protected void	engineReset() Resets the digest for further use.
protected void	engineUpdate(byte input) Updates the digest using the specified byte.
protected void	engineUpdate(byte[] input, int offset, int len) Updates the digest using the specified array of bytes, starting at the specified offset.
protected void	engineUpdate(java.nio.ByteBuffer buff)

Methods inherited from class java.lang.Object

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

Field Detail

mMechType

protected long mMechType

mByteArray

protected byte[] mByteArray

Constructor Detail

LunaDigest

protected LunaDigest(long mechType)

Creates a new LunaDigest using a PKCS11 mechanism type to specify the digest type. For internal use only.

Parameters:

mechType - PKCS11 mechanism type for this digest

Method Detail

engineReset

protected void engineReset()

Resets the digest for further use.

Specified by:

engineReset in class java.security.MessageDigestSpi

engineUpdate

protected void engineUpdate(byte input)

Updates the digest using the specified byte.

Specified by:

engineUpdate in class java.security.MessageDigestSpi

Parameters:

input - The byte to use for the update

engineUpdate

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

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

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

len - The number of bytes to use, starting at offset

engineUpdate

protected void engineUpdate(java.nio.ByteBuffer buff)

Overrides:

engineUpdate in class java.security.MessageDigestSpi

engineDigest

protected byte[] engineDigest()

Runs the hash computation on the accumulated data and returns the result in a new byte array. The accumulated data will be cleared after this operation completes.

Specified by:

engineDigest in class java.security.MessageDigestSpi

Returns:

The array of bytes for the resulting digest operation

engineDigest

protected int engineDigest(byte[] output,
               int offset,
               int len)
                    throws java.security.DigestException

Runs the hash computation on the accumulated data and copies the result into the specified buffer. The accumulated data will be cleared after this operation completes.

Overrides:

engineDigest in class java.security.MessageDigestSpi

Parameters:

output - The digest is copied into this buffer. A DigestException will be thrown if the buffer from the offset forward is too short to contain the digest output

offset - Offset into the destination buffer

len - The amount of the buffer to use for the digest. A DigestException is thrown if this value is less than the size of the digest

Returns:

The length of the digest stored in the output buffer

Throws:

java.security.DigestException - The given output buffer is too small

engineGetDigestLength

protected abstract int engineGetDigestLength()

Returns the digest length in bytes.

Overrides:

engineGetDigestLength in class java.security.MessageDigestSpi

Returns:

The digest length, in bytes

clone

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

Cloning is not supported for Luna message digests.

Overrides:

clone in class java.security.MessageDigestSpi

Throws:

java.lang.CloneNotSupportedException - exception