java.security

Class MessageDigestSpi

  • Direct Known Subclasses:
    MessageDigest

    public abstract class MessageDigestSpi
    extends Object
    This class defines the Service Provider Interface (SPI) for the MessageDigest class, which provides the functionality of a message digest algorithm, such as MD5 or SHA. Message digests are secure one-way hash functions that take arbitrary-sized data and output a fixed-length hash value.

    All the abstract methods in this class must be implemented by a cryptographic service provider who wishes to supply the implementation of a particular message digest algorithm.

    Implementations are free to implement the Cloneable interface.

    See Also:
    MessageDigest
    • Constructor Summary

      Constructors 
      Constructor and Description
      MessageDigestSpi() 

        

    • Method Summary

      Methods 
      Modifier and Type Method and Description
      Object clone()
      Returns a clone if the implementation is cloneable.
      protected abstract byte[] engineDigest()
      Completes the hash computation by performing final operations such as padding.
      protected int engineDigest(byte[] buf, int offset, int len)
      Completes the hash computation by performing final operations such as padding.
      protected int engineGetDigestLength()
      Returns the digest length in bytes.
      protected abstract void engineReset()
      Resets the digest for further use.
      protected abstract void engineUpdate(byte input)
      Updates the digest using the specified byte.
      protected abstract 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(ByteBuffer input)
      Update the digest using the specified ByteBuffer.

        

    • Constructor Detail

      • MessageDigestSpi

        public MessageDigestSpi()
    • Method Detail

      • engineGetDigestLength

        protected int engineGetDigestLength()
        Returns the digest length in bytes.

        This concrete method has been added to this previously-defined abstract class. (For backwards compatibility, it cannot be abstract.)

        The default behavior is to return 0.

        This method may be overridden by a provider to return the digest length.

        Returns:
        the digest length in bytes.
        Since:
        1.2
      • engineUpdate

        protected abstract void engineUpdate(byte input)
        Updates the digest using the specified byte.
        Parameters:
        input - the byte to use for the update.
      • engineUpdate

        protected abstract void engineUpdate(byte[] input,
                        int offset,
                        int len)
        Updates the digest using the specified array of bytes, starting at the specified offset.
        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(ByteBuffer input)
        Update the digest using the specified ByteBuffer. The digest is updated using the input.remaining() bytes starting at input.position(). Upon return, the buffer's position will be equal to its limit; its limit will not have changed.
        Parameters:
        input - the ByteBuffer
        Since:
        1.5
      • engineDigest

        protected abstract byte[] engineDigest()
        Completes the hash computation by performing final operations such as padding. Once engineDigest has been called, the engine should be reset (see engineReset). Resetting is the responsibility of the engine implementor.
        Returns:
        the array of bytes for the resulting hash value.
      • engineDigest

        protected int engineDigest(byte[] buf,
                       int offset,
                       int len)
                            throws DigestException
        Completes the hash computation by performing final operations such as padding. Once engineDigest has been called, the engine should be reset (see engineReset). Resetting is the responsibility of the engine implementor. This method should be abstract, but we leave it concrete for binary compatibility. Knowledgeable providers should override this method.
        Parameters:
        buf - the output buffer in which to store the digest
        offset - offset to start from in the output buffer
        len - 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:
        DigestException - if an error occurs.
        Since:
        1.2
      • engineReset

        protected abstract void engineReset()
        Resets the digest for further use.

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Document créé le 31/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-java/security/MessageDigestSpi.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : https://docs.oracle.com, MessageDigestSpi

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut