Класс MessageDigestSpi

java.lang.Object

java.security.MessageDigestSpi

Прямые известные подклассы:: MessageDigest

public abstract class MessageDigestSpi extends Object

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

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

Реализации могут свободно реализовывать интерфейс Cloneable.

C момента:

1.2

См. также:

MessageDigest

Краткое описание конструкторов

Конструктор	Описание
`MessageDigestSpi()`	Конструктор для вызова подклассами.

Краткое описание методов

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Возвращает копию, если реализация поддерживает клонирование.
`protected abstract byte[]`	`engineDigest()`	Завершает вычисление хэша, выполняя окончательные операции, такие как заполнение.
`protected int`	`engineDigest(byte[] buf, int offset, int len)`	Завершает вычисление хэша, выполняя окончательные операции, такие как заполнение.
`protected int`	`engineGetDigestLength()`	Возвращает длину хэша в байтах.
`protected abstract void`	`engineReset()`	Сбрасывает хэш для дальнейшего использования.
`protected abstract void`	`engineUpdate(byte input)`	Обновляет хэш, используя указанный байт.
`protected abstract void`	`engineUpdate(byte[] input, int offset, int len)`	Обновляет хэш, используя указанный массив байтов, начиная с указанного смещения.
`protected void`	`engineUpdate(ByteBuffer input)`	Обновляет хэш, используя указанный ByteBuffer.

Методы, объявленные в классе java.lang.Object

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

Подробное описание конструкторов

MessageDigestSpi

public MessageDigestSpi()

Конструктор для вызова подклассами.

Подробное описание методов

engineGetDigestLength

protected int engineGetDigestLength()

Возвращает длину хэша в байтах.

Этот конкретный метод был добавлен в этот ранее определённый абстрактный класс. (Для обратной совместимости он не может быть абстрактным.)

По умолчанию возвращает 0.

Этот метод может быть переопределен поставщиком для возвращения длины хэша.

Возвращает:: длину хэша в байтах.
C момента:: 1.2

engineUpdate

protected abstract void engineUpdate(byte input)

Обновляет хэш, используя указанный байт.

Параметры:: input - байт, используемый для обновления.

engineUpdate

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

Обновляет хэш, используя указанный массив байтов, начиная с указанного смещения.

Параметры:: input - массив байтов, используемый для обновления.; offset - смещение для начала в массиве байтов.; len - количество байтов, используемых, начиная со смещения offset.

engineUpdate

protected void engineUpdate(ByteBuffer input)

Обновляет хэш, используя указанный ByteBuffer. Хэш обновляется с использованием input.remaining() байтов, начиная с input.position(). По возвращении позиция буфера будет равна его пределу; его предел не изменится.

Параметры:: input - ByteBuffer
C момента:: 1.5

engineDigest

protected abstract byte[] engineDigest()

Возвращает:: массив байтов для результирующего значения хэша.

engineDigest

protected int engineDigest(byte[] buf, int offset, int len) throws DigestException

Завершает вычисление хэша, выполняя окончательные операции, такие как заполнение. После вызова engineDigest, движок должен быть сброшен (см. engineReset). Сброс является ответственностью реализатора движка. Этот метод должен быть абстрактным, но мы оставляем его конкретным для обратной совместимости. Знающие поставщики должны переопределить этот метод.

Параметры:: buf - буфер вывода, в котором необходимо хранить хэш; offset - смещение для начала в буфере вывода; len - количество байтов в buf, выделенных для хэша. Как эта реализация по умолчанию, так и поставщик SUN не возвращают частичные хэши. Наличие этого параметра исключительно для согласованности в нашем API. Если значение этого параметра меньше фактической длины хэша, метод будет выбрасывать DigestException. Этот параметр игнорируется, если его значение больше или равно фактической длине хэша.
Возвращает:: длину хэша, сохраненного в буфере вывода.
Исключения:: DigestException - если произошла ошибка.
C момента:: 1.2

engineReset

protected abstract void engineReset()

Сбрасывает хэш для дальнейшего использования.

clone

public Object clone() throws CloneNotSupportedException

Возвращает копию, если реализация поддерживает клонирование.

Переопределяет:

clone в классе Object

Возвращает:

копию, если реализация поддерживает клонирование.

Исключения:

CloneNotSupportedException - если это вызывается на реализации, которая не поддерживает Cloneable.

См. также:

Cloneable

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/security/MessageDigestSpi.html