ExemptionMechanism (Платформа Java SE 7)

java.lang. Объект
- javax.crypto. ExemptionMechanism

```
public class ExemptionMechanism
extends Object
```
Этот класс обеспечивает функциональность механизма освобождения, примерами которого является ключевое восстановление, ключевое ослабление, и манипулируют условное депонирование.
Приложениям или апплетам, которые используют механизм освобождения, можно предоставить более сильные возможности шифрования чем те, которые не делают.

С тех пор:

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)` Возвраты, был ли блоб результата сгенерирован успешно этим механизмом освобождения.

Методы 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 в классе Object

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс ExemptionMechanism

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

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

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

Деталь конструктора

ExemptionMechanism

Деталь метода

getName

getInstance

getInstance

getInstance

getProvider

isCryptoAllowed

getOutputSize

init

init

init

genExemptionBlob

genExemptionBlob

genExemptionBlob

завершить