Класс ExemptionMechanism

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

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

public final String getName()

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

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

public static final ExemptionMechanism getInstance(String algorithm) throws NoSuchAlgorithmException

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

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

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

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

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

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

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

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

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

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

public final Provider getProvider()

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

public final boolean isCryptoAllowed(Key key) throws ExemptionMechanismException

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

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

public final int getOutputSize(int inputLen) throws IllegalStateException

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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