Класс ExemptionMechanism

java.lang.Object

javax.crypto.ExemptionMechanism

public class ExemptionMechanism extends Object

Этот класс предоставляет функциональность механизма освобождения; его примерами являются восстановление ключа, ослабление ключа и депонирование ключа.

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

Начиная с:: 1.4

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

ExemptionMechanism(ExemptionMechanismSpi exmechSpi,
 Provider provider,
 String mechanism)

Модификатор	Конструктор	Описание
`protected`	Создает объект `ExemptionMechanism`.

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

Модификатор и тип	Метод	Описание
`final byte[]`	`genExemptionBlob()`	Создает блок ключа механизма освобождения.
`final int`	`genExemptionBlob(byte[] output)`	Создает блок ключа механизма освобождения и сохраняет результат в буфере `output`.
`final int`	`genExemptionBlob(byte[] output, int outputOffset)`	Создает блок ключа механизма освобождения и сохраняет результат в буфере `output`, начиная с позиции `outputOffset` включительно.
`static final ExemptionMechanism`	`getInstance(String algorithm)`	Возвращает объект `ExemptionMechanism`, реализующий указанный алгоритм механизма освобождения.
`static final ExemptionMechanism`	`getInstance(String algorithm, String provider)`	Возвращает объект `ExemptionMechanism`, реализующий указанный алгоритм механизма освобождения.
`static final ExemptionMechanism`	`getInstance(String algorithm, Provider provider)`	Возвращает объект `ExemptionMechanism`, реализующий указанный алгоритм механизма освобождения.
`final String`	`getName()`	Возвращает название механизма освобождения для этого объекта `ExemptionMechanism`.
`final int`	`getOutputSize(int inputLen)`	Возвращает длину в байтах, которая требуется выходному буферу для хранения результата следующей операции `genExemptionBlob` при заданной длине входных данных `inputLen` (в байтах).
`final Provider`	`getProvider()`	Возвращает поставщика этого объекта `ExemptionMechanism`.
`final void`	`init(Key key)`	Инициализирует этот механизм освобождения с помощью ключа.
`final void`	`init(Key key, AlgorithmParameters params)`	Инициализирует этот механизм освобождения с помощью ключа и набора параметров алгоритма.
`final void`	`init(Key key, AlgorithmParameterSpec params)`	Инициализирует этот механизм освобождения с помощью ключа и набора параметров алгоритма.
`final boolean`	`isCryptoAllowed(Key key)`	Возвращает сведения о том, был ли блок результата успешно создан этим механизмом освобождения.

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

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

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

ExemptionMechanism

protected ExemptionMechanism(ExemptionMechanismSpi exmechSpi, Provider provider, String mechanism)

Создает объект ExemptionMechanism.

Параметры:: exmechSpi — делегат; provider — поставщик; mechanism — механизм освобождения

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

getName

public final String getName()

Возвращает название механизма освобождения для этого объекта ExemptionMechanism.

Это то же название, которое было указано в одном из вызовов getInstance, создавших этот объект ExemptionMechanism.

Возвращает:: название механизма освобождения для этого объекта ExemptionMechanism.

getInstance

public static final ExemptionMechanism getInstance(String algorithm) throws NoSuchAlgorithmException

Возвращает объект ExemptionMechanism, реализующий указанный алгоритм механизма освобождения.

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

Обратите внимание, что список зарегистрированных поставщиков можно получить с помощью метода Security.getProviders().

Примечание по реализации:

Реализация JDK Reference Implementation дополнительно использует свойство jdk.security.provider.preferred Security, чтобы определить предпочтительный порядок поставщиков для указанного алгоритма. Он может отличаться от порядка поставщиков, возвращаемых методом Security.getProviders().

Параметры:

algorithm — стандартное название запрашиваемого механизма освобождения. Сведения о стандартных названиях механизмов освобождения см. в разделе ExemptionMechanism спецификации «Стандартные названия алгоритмов безопасности Java».

Возвращает:

новый объект ExemptionMechanism

Вызывает исключения:

NoSuchAlgorithmException — если ни один Provider не поддерживает реализацию ExemptionMechanismSpi для указанного алгоритма

NullPointerException — если algorithm равно null

Внешние спецификации

См. также:

getInstance

public static final ExemptionMechanism getInstance(String algorithm, String provider) throws NoSuchAlgorithmException, NoSuchProviderException

Возвращает объект ExemptionMechanism, реализующий указанный алгоритм механизма освобождения.

Возвращается новый объект ExemptionMechanism, включающий реализацию ExemptionMechanismSpi от указанного поставщика. Указанный поставщик должен быть зарегистрирован в списке поставщиков безопасности.

Параметры:

provider — название поставщика.

Возвращает:

новый объект ExemptionMechanism

Вызывает исключения:

IllegalArgumentException — если provider равно null или пусто

NoSuchAlgorithmException — если реализация ExemptionMechanismSpi для указанного алгоритма недоступна у указанного поставщика

NoSuchProviderException — если указанный поставщик не зарегистрирован в списке поставщиков безопасности

NullPointerException — если algorithm равно null

Внешние спецификации

См. также:

getInstance

public static final ExemptionMechanism getInstance(String algorithm, Provider provider) throws NoSuchAlgorithmException

Возвращает объект ExemptionMechanism, реализующий указанный алгоритм механизма освобождения.

Возвращается новый объект ExemptionMechanism, включающий реализацию ExemptionMechanismSpi от указанного объекта поставщика. Обратите внимание, что указанный объект поставщика не обязательно должен быть зарегистрирован в списке поставщиков.

Параметры:

provider — поставщик.

Возвращает:

новый объект ExemptionMechanism

Вызывает исключения:

IllegalArgumentException — если provider равно null

NoSuchAlgorithmException — если реализация ExemptionMechanismSpi для указанного алгоритма недоступна у указанного объекта Provider

NullPointerException — если algorithm равно null

Внешние спецификации

См. также:

getProvider

public final Provider getProvider()

Возвращает поставщика этого объекта ExemptionMechanism.

Возвращает:: поставщика этого объекта ExemptionMechanism.

isCryptoAllowed

public final boolean isCryptoAllowed(Key key) throws ExemptionMechanismException

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

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

Параметры:: key — ключ, который будет использоваться для криптографических операций.
Возвращает:: сведения о том, был ли блок результата для того же ключа успешно создан этим механизмом освобождения; false, если key равно null.
Вызывает исключения:: ExemptionMechanismException — если при определении того, был ли блок результата успешно создан этим объектом механизма освобождения, возникли проблемы.

getOutputSize

public final int getOutputSize(int inputLen) throws IllegalStateException

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

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

Параметры:: inputLen — длина входных данных (в байтах)
Возвращает:: требуемый размер выходного буфера (в байтах)
Вызывает исключения:: IllegalStateException — если этот механизм освобождения находится в неправильном состоянии (например, еще не был инициализирован)

init

public final void init(Key key) throws InvalidKeyException, ExemptionMechanismException

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

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

Параметры:: key — ключ для этого механизма освобождения
Вызывает исключения:: InvalidKeyException — если заданный ключ не подходит для этого механизма освобождения.; ExemptionMechanismException — если в процессе инициализации возникли проблемы.

init

public final void init(Key key, AlgorithmParameterSpec params) throws InvalidKeyException, InvalidAlgorithmParameterException, ExemptionMechanismException

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

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

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

init

public final void init(Key key, AlgorithmParameters params) throws InvalidKeyException, InvalidAlgorithmParameterException, ExemptionMechanismException

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

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

genExemptionBlob

public final byte[] genExemptionBlob() throws IllegalStateException, ExemptionMechanismException

Создает блок ключа механизма освобождения.

Возвращает:: новый буфер с блоком ключа результата.
Вызывает исключения:: IllegalStateException — если этот механизм освобождения находится в неправильном состоянии (например, еще не был инициализирован).; ExemptionMechanismException — если в процессе создания возникли проблемы.

genExemptionBlob

public final int genExemptionBlob(byte[] output) throws IllegalStateException, ShortBufferException, ExemptionMechanismException

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

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

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

genExemptionBlob

public final int genExemptionBlob(byte[] output, int outputOffset) throws IllegalStateException, ShortBufferException, ExemptionMechanismException

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

Параметры:: output — буфер для результата; outputOffset — смещение в output, по которому сохраняется результат
Возвращает:: количество байтов, сохраненных в output
Вызывает исключения:: IllegalStateException — если этот механизм освобождения находится в неправильном состоянии (например, еще не был инициализирован).; 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://docs.oracle.com/en/java/javase/25/docs/api/java.base/javax/crypto/ExemptionMechanism.html