javax.crypto

Класс ExemptionMechanism

java.lang. Объект

javax.crypto. ExemptionMechanism

public class ExemptionMechanism
extends Object

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

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

С тех пор:

1.4

Сводка конструктора

Конструкторы

Модификатор	Конструктор и Описание
protected	ExemptionMechanism(ExemptionMechanismSpi exmechSpi, Provider provider, String mechanism) Создает объект ExemptionMechanism.

Сводка метода

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

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

clone, equals, 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() метод.

Параметры:

algorithm - стандартное имя требуемого механизма освобождения. См. раздел ExemptionMechanism в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах механизма освобождения.

Возвраты:

новое ExemptionMechanism объект.

Броски:

NullPointerException - если algorithm нуль.

NoSuchAlgorithmException - если никакой Провайдер не поддерживает реализацию ExemptionMechanismSpi для указанного алгоритма.

См. Также:

Provider

getInstance

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

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

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

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

Параметры:

algorithm - стандартное имя требуемого механизма освобождения. См. раздел ExemptionMechanism в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах механизма освобождения.

provider - имя провайдера.

Возвраты:

новое ExemptionMechanism объект.

Броски:

NullPointerException - если algorithm нуль.

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

NoSuchProviderException - если указанный провайдер не регистрируется в списке поставщика систем обеспечения безопасности.

IllegalArgumentException - если provider нуль или пустой.

См. Также:

Provider

getInstance

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

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

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

Параметры:

algorithm - стандартное имя требуемого механизма освобождения. См. раздел ExemptionMechanism в Документации Имени Алгоритма Стандарта Архитектуры Криптографии Java для информации о стандартных именах механизма освобождения.

provider - провайдер.

Возвраты:

новое ExemptionMechanism объект.

Броски:

NullPointerException - если algorithm нуль.

NoSuchAlgorithmException - если реализация ExemptionMechanismSpi для указанного алгоритма не доступна от указанного объекта Провайдера.

IllegalArgumentException - если provider нуль.

См. Также:

Provider

getProvider

public final Provider getProvider()

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

Возвраты:

провайдер этого ExemptionMechanism объект.

isCryptoAllowed

public final boolean isCryptoAllowed(Key key)
                              throws ExemptionMechanismException

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

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

Параметры:

key - ключ crypto собирается использовать.

Возвраты:

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

Броски:

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 нуль, базовая реализация механизма освобождения, как предполагается, генерирует обязательные параметры самостоятельно (использующий специфичные для провайдера значения по умолчанию); в случае, что параметры алгоритма должны быть определены вызывающей стороной, InvalidAlgorithmParameterException повышается.

Параметры:

key - ключ для этого механизма освобождения

params - параметры алгоритма

Броски:

InvalidKeyException - если данный ключ является несоответствующим для этого механизма освобождения.

InvalidAlgorithmParameterException - если данные параметры алгоритма являются несоответствующими для этого механизма освобождения.

ExemptionMechanismException - если проблема (ы) встречалась в процессе инициализации.

init

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

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

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

Параметры:

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 буфер является слишком маленьким, чтобы содержать результат, a ShortBufferException бросается. В этом случае повторите этот вызов с большим буфером вывода. Использовать getOutputSize определить, насколько большой буфер вывода должен быть.

Параметры:

output - буфер для результата

Возвраты:

число байтов, сохраненных в output

Броски:

IllegalStateException - если этот механизм освобождения находится в неправильном состоянии (например, не был инициализирован).

ShortBufferException - если данный буфер вывода является слишком небольшим, чтобы содержать результат.

ExemptionMechanismException - если проблема (ы) встречалась в процессе генерирования.

genExemptionBlob

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

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

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

Параметры:

output - буфер для результата

outputOffset - смещение в output где результат сохранен

Возвраты:

число байтов, сохраненных в output

Броски:

IllegalStateException - если этот механизм освобождения находится в неправильном состоянии (например, не был инициализирован).

ShortBufferException - если данный буфер вывода является слишком небольшим, чтобы содержать результат.

ExemptionMechanismException - если проблема (ы) встречалась в процессе генерирования.

завершить

protected void finalize()

Гарантирует, что ключ, хранивший этим объектом ExemptionMechanism, будет вытерт, когда не будет больше ссылок на это.

Переопределения:

finalize в class Object

См. Также:

WeakReference, PhantomReference