Класс MacSpi

java.lang.Object

javax.crypto.MacSpi

public abstract class MacSpi extends Object

Этот класс определяет Интерфейс поставщика сервисов (SPI) для класса Mac. Все абстрактные методы в этом классе должны быть реализованы каждым поставщиком криптографических сервисов, желающим предоставить реализацию конкретного алгоритма MAC.

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

С момента:: 1.4

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

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

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

Модификатор и тип	Метод	Описание
`Object`	`clone()`	Возвращает клон, если реализация клонируема.
`protected abstract byte[]`	`engineDoFinal()`	Завершает вычисление MAC и сбрасывает MAC для дальнейшего использования, сохраняя секретный ключ, с которым MAC был инициализирован.
`protected abstract int`	`engineGetMacLength()`	Возвращает длину MAC в байтах.
`protected abstract void`	`engineInit(Key key, AlgorithmParameterSpec params)`	Инициализирует MAC заданным (секретным) ключом и параметрами алгоритма.
`protected abstract void`	`engineReset()`	Сбрасывает MAC для дальнейшего использования, сохраняя секретный ключ, с которым MAC был инициализирован.
`protected abstract void`	`engineUpdate(byte input)`	Обрабатывает заданный байт.
`protected abstract void`	`engineUpdate(byte[] input, int offset, int len)`	Обрабатывает первые `len` байты в `input`, начиная с `offset` включительно.
`protected void`	`engineUpdate(ByteBuffer input)`	Обрабатывает `input.remaining()` байтов в ByteBuffer `input`, начиная с `input.position()`. После возврата позиция буфера будет равна его пределу; его предел не изменится. Подклассы должны рассмотреть возможность переопределения этого метода, если они могут обрабатывать ByteBuffer более эффективно, чем массивы байтов.

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

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

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

MacSpi

public MacSpi()

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

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

engineGetMacLength

protected abstract int engineGetMacLength()

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

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

engineInit

protected abstract void engineInit(Key key, AlgorithmParameterSpec params) throws InvalidKeyException, InvalidAlgorithmParameterException

Инициализирует MAC заданным (секретным) ключом и параметрами алгоритма.

Параметры:: key - (секретный) ключ.; params - параметры алгоритма.
Исключения:: InvalidKeyException - если заданный ключ не подходит для инициализации данного MAC.; InvalidAlgorithmParameterException - если заданные параметры алгоритма не подходят для данного MAC.

engineUpdate

protected abstract void engineUpdate(byte input)

Обрабатывает заданный байт.

Параметры:: input - входной байт для обработки.

engineUpdate

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

Обрабатывает первые len байты в input, начиная с offset включительно.

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

engineUpdate

protected void engineUpdate(ByteBuffer input)

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

Подклассы должны рассмотреть возможность переопределения этого метода, если они могут обрабатывать ByteBuffer более эффективно, чем массивы байтов.

Параметры:: input - ByteBuffer
Исключения:: NullPointerException - если input равен null
С момента:: 1.5

engineDoFinal

protected abstract byte[] engineDoFinal()

Завершает вычисление MAC и сбрасывает MAC для дальнейшего использования, сохраняя секретный ключ, с которым MAC был инициализирован.

Возвращает:: результат MAC.

engineReset

protected abstract void engineReset()

Сбрасывает MAC для дальнейшего использования, сохраняя секретный ключ, с которым MAC был инициализирован.

clone

public Object clone() throws CloneNotSupportedException

Возвращает клон, если реализация клонируема.

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

clone в классе Object

Возвращает:

клон, если реализация клонируема.

Исключения:

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

См. также:

© 1993, 2023, 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/21/docs/api/java.base/javax/crypto/MacSpi.html