Класс ExemptionMechanismSpi

java.lang.Object

javax.crypto.ExemptionMechanismSpi

public abstract class ExemptionMechanismSpi extends Object

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

Since:: 1.4

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

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

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

Модификатор и тип	Метод	Описание
`protected abstract byte[]`	`engineGenExemptionBlob()`	Генерирует blob ключа механизма исключения.
`protected abstract int`	`engineGenExemptionBlob(byte[] output, int outputOffset)`	Генерирует blob ключа механизма исключения и сохраняет результат в буфере `output`, начиная с индекса `outputOffset`.
`protected abstract int`	`engineGetOutputSize(int inputLen)`	Возвращает длину (в байтах), необходимую для буфера вывода, чтобы содержать результат следующей операции `engineGenExemptionBlob`, учитывая длину входных данных `inputLen` (в байтах).
`protected abstract void`	`engineInit(Key key)`	Инициализирует этот механизм исключения ключом.
`protected abstract void`	`engineInit(Key key, AlgorithmParameters params)`	Инициализирует этот механизм исключения ключом и набором параметров алгоритма.
`protected abstract void`	`engineInit(Key key, AlgorithmParameterSpec params)`	Инициализирует этот механизм исключения ключом и набором параметров алгоритма.

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

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

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

ExemptionMechanismSpi

public ExemptionMechanismSpi()

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

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

engineGetOutputSize

protected abstract int engineGetOutputSize(int inputLen)

Возвращает длину (в байтах), необходимую для буфера вывода, чтобы содержать результат следующей операции engineGenExemptionBlob, учитывая длину входных данных inputLen (в байтах).

Фактическая длина вывода следующего вызова engineGenExemptionBlob может быть меньше, чем длина, возвращенная этим методом.

Параметры:: inputLen - длина входных данных (в байтах)
Возвращает:: необходимый размер буфера вывода (в байтах)

engineInit

protected abstract void engineInit(Key key) throws InvalidKeyException, ExemptionMechanismException

Инициализирует этот механизм исключения ключом.

Если этому механизму исключения требуются какие-либо параметры алгоритма, которые нельзя вывести из предоставленного key, предполагается, что реализация базового механизма исключения сгенерирует необходимые параметры самостоятельно (используя значения по умолчанию, специфичные для поставщика); в случае, если параметры алгоритма должны быть указаны вызывающим объектом, возбуждается InvalidKeyException.

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

engineInit

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

Инициализирует этот механизм исключения ключом и набором параметров алгоритма.

Если этому механизму исключения требуются какие-либо параметры алгоритма, и params равно null, предполагается, что реализация базового механизма исключения сгенерирует необходимые параметры самостоятельно (используя значения по умолчанию, специфичные для поставщика); в случае, если параметры алгоритма должны быть указаны вызывающим объектом, возбуждается InvalidAlgorithmParameterException.

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

engineInit

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

Инициализирует этот механизм исключения ключом и набором параметров алгоритма.

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

engineGenExemptionBlob

protected abstract byte[] engineGenExemptionBlob() throws ExemptionMechanismException

Генерирует blob ключа механизма исключения.

Возвращает:: новый буфер с результатом blob ключа.
Исключения:: ExemptionMechanismException - если возникла(и) проблема(ы) в процессе генерации.

engineGenExemptionBlob

protected abstract int engineGenExemptionBlob(byte[] output, int outputOffset) throws ShortBufferException, ExemptionMechanismException

Генерирует blob ключа механизма исключения и сохраняет результат в буфере output, начиная с индекса outputOffset.

Если буфер output недостаточно велик для хранения результата, возбуждается исключение ShortBufferException. В этом случае повторите этот вызов с более большим буфером вывода. Используйте engineGetOutputSize для определения размера буфера вывода.

Параметры:: output - буфер для результата; outputOffset - смещение в output, где хранится результат
Возвращает:: количество байтов, сохраненных в output
Исключения:: ShortBufferException - если заданный буфер вывода недостаточно велик для хранения результата.; ExemptionMechanismException - если возникла(и) проблема(ы) в процессе генерации.

© 1993, 2025, 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://download.java.net/java/early_access/jdk24/docs/api/java.base/javax/crypto/ExemptionMechanismSpi.html