Класс MessageDigest

public abstract class MessageDigest
extends MessageDigestSpi

Этот класс MessageDigest предоставляет приложениям функциональность алгоритма дайджеста сообщений, такого как SHA-1 или SHA-256. Дайджесты сообщений — это безопасные односторонние хеш-функции, которые принимают данные произвольной длины и возвращают хеш-значение фиксированной длины.

Объект MessageDigest инициализируется в исходном состоянии. Данные обрабатываются с помощью методов update. В любой момент можно вызвать reset для сброса дайджеста. После обновления всех данных, которые необходимо обновить, следует вызвать один из методов digest для завершения вычисления хеша.

Метод digest может быть вызван один раз для заданного количества обновлений. После того, как digest был вызван, объект MessageDigest сбрасывается в исходное состояние.

Реализации могут свободно реализовывать интерфейс Cloneable. Приложения-клиенты могут проверить возможность клонирования, попытавшись клонировать и перехватить исключение CloneNotSupportedException:

MessageDigest md = MessageDigest.getInstance("SHA-256");

 try {
     md.update(toChapter1);
     MessageDigest tc1 = md.clone();
     byte[] toChapter1Digest = tc1.digest();
     md.update(toChapter2);
     ...etc.
 } catch (CloneNotSupportedException cnse) {
     throw new DigestException("couldn't make digest of partial content");
 }

Обратите внимание, что если данная реализация не поддерживает клонирование, то всё равно возможно вычисление промежуточных дайджестов путём создания нескольких экземпляров, если количество дайджестов известно заранее.

Обратите внимание, что этот класс является абстрактным и наследуется от MessageDigestSpi по историческим причинам. Разработчики приложений должны обращать внимание только на методы, определённые в этом MessageDigest классе; все методы в суперклассе предназначены для поставщиков криптографических сервисов, которые хотят предоставить свои собственные реализации алгоритмов дайджеста сообщений.

Каждая реализация Java-платформы обязана поддерживать следующие стандартные MessageDigest алгоритмы:

• MD5
• SHA-1
• SHA-256

Эти алгоритмы описаны в разделе «MessageDigest» спецификации Java Security Standard Algorithm Names Specification по адресу MessageDigest section. Обратитесь к документации выпуска вашей реализации, чтобы узнать, поддерживаются ли какие-либо другие алгоритмы.