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

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

```
public abstract class CipherSpi
extends Object
```
Этот класс определяет Интерфейс Поставщика услуг (SPI) для Cipher класс. Все абстрактные методы в этом классе должны быть реализованы каждым провайдером криптографических служб, который хочет предоставить реализацию определенного алгоритма шифра.
Чтобы создать экземпляр Cipher, который инкапсулирует экземпляр этого CipherSpi класс, приложение вызывает один из getInstance методы фабрики Cipher класс механизма и определяет требуемое преобразование. Дополнительно, приложение может также определить имя провайдера.
Преобразование является строкой, которая описывает работу (или набор операций), чтобы быть выполненной на данном вводе, произвести некоторый вывод. Преобразование всегда включает имя криптографического алгоритма (например, DES), и может сопровождаться режимом обратной связи и дополнительной схемой.
Преобразование имеет форму:
- "алгоритм/режим/дополнение" или
- "алгоритм"
(в последнем случае специфичные для провайдера значения по умолчанию для режима и дополнительной схемы используются). Например, следующее является допустимым преобразованием:
```
     Cipher c = Cipher.getInstance("DES/CBC/PKCS5Padding");
 
```
Провайдер может предоставить отдельный класс для каждой комбинации алгоритма/режима/дополнения, или может решить обеспечить больше универсальных классов, представляющих подпреобразования, соответствующие алгоритму или алгоритму/режиму, или алгоритм//дополняющий (отметьте двойные наклонные черты), когда требуемый режим и/или дополнение устанавливаются автоматически getInstance методы Cipher, которые вызывают engineSetMode и engineSetPadding методы подкласса провайдера CipherSpi.
A Cipher у свойства в мастер классе провайдера может быть один из следующих форматов:
- ```
     // provider's subclass of "CipherSpi" implements "algName" with
     // pluggable mode and padding
     Cipher.algName
 
```
- ```
     // provider's subclass of "CipherSpi" implements "algName" in the
     // specified "mode", with pluggable padding
     Cipher.algName/mode
 
```
- ```
     // provider's subclass of "CipherSpi" implements "algName" with the
     // specified "padding", with pluggable mode
     Cipher.algName//padding
 
```
- ```
     // provider's subclass of "CipherSpi" implements "algName" with the
     // specified "mode" and "padding"
     Cipher.algName/mode/padding
 
```
Например, провайдер может предоставить подкласс CipherSpi это реализует DES/ECB/PKCS5Padding, тот, который реализует DES/CBC/PKCS5Padding, тот, который реализует DES/CFB/PKCS5Padding, и еще один, который реализует DES/OFB/PKCS5Padding. У того провайдера был бы следующий Cipher свойства в его мастер классе:
- ```
     Cipher.DES/ECB/PKCS5Padding
 
```
- ```
     Cipher.DES/CBC/PKCS5Padding
 
```
- ```
     Cipher.DES/CFB/PKCS5Padding
 
```
- ```
     Cipher.DES/OFB/PKCS5Padding
 
```
Другой провайдер может реализовать класс для каждого из вышеупомянутых режимов (то есть, один класс для ECB, один для CBC, один для CFB, и один для OFB), один класс для PKCS5Padding, и универсальный класс DES, который разделяет на подклассы от CipherSpi. У того провайдера был бы следующий Cipher свойства в его мастер классе:
- ```
     Cipher.DES
 
```
getInstance метод фабрики Cipher класс механизма следует за этими правилами, чтобы инстанцировать реализации провайдера CipherSpi для преобразования формы "алгоритм":
1. Проверьте, зарегистрировал ли провайдер подкласс CipherSpi для указанного "алгоритма".
  Если ответ ДА, инстанцируйте этого класса, для того, используются режим которого и дополнительные значения по умолчанию схемы (как предоставлено провайдером).
  Если ответ нет, бросок a NoSuchAlgorithmException исключение.
getInstance метод фабрики Cipher класс механизма следует за этими правилами, чтобы инстанцировать реализации провайдера CipherSpi для преобразования формы "алгоритм/режим/дополнение":
1. Проверьте, зарегистрировал ли провайдер подкласс CipherSpi для указанного преобразования "алгоритма/режима/дополнения".
  Если ответ ДА, инстанцируйте его.
  Если ответ нет, пойдите в следующий шаг.
2. Проверьте, зарегистрировал ли провайдер подкласс CipherSpi для подпреобразования "алгоритм/режим".
  Если ответ ДА, инстанцируйте его, и вызов engineSetPadding(padding) на новом экземпляре.
  Если ответ нет, пойдите в следующий шаг.
3. Проверьте, зарегистрировал ли провайдер подкласс CipherSpi для подпреобразования "алгоритм//дополняющий" (отмечают двойные наклонные черты).
  Если ответ ДА, инстанцируйте его, и вызов engineSetMode(mode) на новом экземпляре.
  Если ответ нет, пойдите в следующий шаг.
4. Проверьте, зарегистрировал ли провайдер подкласс CipherSpi для подпреобразования "алгоритм".
  Если ответ ДА, инстанцируйте его, и вызов engineSetMode(mode) и engineSetPadding(padding) на новом экземпляре.
  Если ответ нет, бросок a NoSuchAlgorithmException исключение.
С тех пор:

1.4

См. Также:
KeyGenerator, SecretKey

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

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

CipherSpi()

Конструкторы
Конструктор и Описание
`CipherSpi()`

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

Методы
Модификатор и Тип	Метод и Описание
`protected abstract byte[]`	`engineDoFinal(byte[] input, int inputOffset, int inputLen)` Шифрует или дешифрует данные в работе единственной части, или заканчивает работу многократной части.
`protected abstract int`	`engineDoFinal(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset)` Шифрует или дешифрует данные в работе единственной части, или заканчивает работу многократной части.
`protected int`	`engineDoFinal(ByteBuffer input, ByteBuffer output)` Шифрует или дешифрует данные в работе единственной части, или заканчивает работу многократной части.
`protected abstract int`	`engineGetBlockSize()` Возвращает размер блока (в байтах).
`protected abstract byte[]`	`engineGetIV()` Возвращает вектор инициализации (IV) в новом буфере.
`protected int`	`engineGetKeySize(Key key)` Возвращает размер ключа данного ключевого объекта в битах.
`protected abstract int`	`engineGetOutputSize(int inputLen)` Возвращает длину в байтах, что буфер вывода должен был бы быть в порядке, чтобы содержать результат следующего `update` или `doFinal` работа, учитывая входную длину `inputLen` (в байтах).
`protected abstract AlgorithmParameters`	`engineGetParameters()` Возвращает параметры, используемые с этим шифром.
`protected abstract void`	`engineInit(int opmode, Key key, AlgorithmParameterSpec params, SecureRandom random)` Инициализирует этот шифр с ключом, ряд параметров алгоритма, и источника случайности.
`protected abstract void`	`engineInit(int opmode, Key key, AlgorithmParameters params, SecureRandom random)` Инициализирует этот шифр с ключом, ряд параметров алгоритма, и источника случайности.
`protected abstract void`	`engineInit(int opmode, Key key, SecureRandom random)` Инициализирует этот шифр с ключом и источником случайности.
`protected abstract void`	`engineSetMode(String mode)` Устанавливает режим этого шифра.
`protected abstract void`	`engineSetPadding(String padding)` Устанавливает дополнительный механизм этого шифра.
`protected Key`	`engineUnwrap(byte[] wrappedKey, String wrappedKeyAlgorithm, int wrappedKeyType)` Разверните ранее обернутый ключ.
`protected abstract byte[]`	`engineUpdate(byte[] input, int inputOffset, int inputLen)` Продолжает шифрование многократной части или работу дешифрования (в зависимости от того, как этот шифр был инициализирован), обрабатывая другую часть данных.
`protected abstract int`	`engineUpdate(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset)` Продолжает шифрование многократной части или работу дешифрования (в зависимости от того, как этот шифр был инициализирован), обрабатывая другую часть данных.
`protected int`	`engineUpdate(ByteBuffer input, ByteBuffer output)` Продолжает шифрование многократной части или работу дешифрования (в зависимости от того, как этот шифр был инициализирован), обрабатывая другую часть данных.
`protected void`	`engineUpdateAAD(byte[] src, int offset, int len)` Продолжает многослойное обновление Дополнительных Данных Аутентификации (AAD), используя подмножество обеспеченного буфера.
`protected void`	`engineUpdateAAD(ByteBuffer src)` Продолжает многослойное обновление Дополнительных Данных Аутентификации (AAD).
`protected byte[]`	`engineWrap(Key key)` Оберните ключ.

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - CipherSpi
```
public CipherSpi()
```
- Деталь метода
  - engineSetMode
```
protected abstract void engineSetMode(String mode)
                               throws NoSuchAlgorithmException
```
    Устанавливает режим этого шифра.
    
    Параметры:
    mode - режим шифра
    
    Броски:
    
    NoSuchAlgorithmException - если требуемый режим шифра не существует
  - engineSetPadding
```
protected abstract void engineSetPadding(String padding)
                                  throws NoSuchPaddingException
```
    Устанавливает дополнительный механизм этого шифра.
    
    Параметры:
    padding - дополнительный механизм
    
    Броски:
    
    NoSuchPaddingException - если требуемый дополнительный механизм не существует
  - engineGetBlockSize
```
protected abstract int engineGetBlockSize()
```
    Возвращает размер блока (в байтах).
    
    Возвраты:
    размер блока (в байтах), или 0, если базовый алгоритм не является блочным шифром
  - engineGetOutputSize
```
protected abstract int engineGetOutputSize(int inputLen)
```
    Возвращает длину в байтах, что буфер вывода должен был бы быть в порядке, чтобы содержать результат следующего update или doFinal работа, учитывая входную длину inputLen (в байтах).
    Этот вызов принимает во внимание любые необработанные (буферизованные) данные от предыдущего update вызовите, дополнение, и тегирование AEAD.
    Фактическая выходная длина следующего update или doFinal вызов может быть меньшим чем длина, возвращенная этим методом.
    
    Параметры:
    inputLen - входная длина (в байтах)
    
    Возвраты:
    необходимый размер буфера вывода (в байтах)
  - engineGetIV
```
protected abstract byte[] engineGetIV()
```
    Возвращает вектор инициализации (IV) в новом буфере.
    Это полезно в контексте основанного на пароле шифрования или дешифрования, где IV получается из предоставленного пользователем пароля.
    
    Возвраты:
    вектор инициализации в новом буфере, или нуль, если базовый алгоритм не использует IV, или если IV еще не был установлен.
  - engineGetParameters
```
protected abstract AlgorithmParameters engineGetParameters()
```
    Возвращает параметры, используемые с этим шифром.
    Возвращенные параметры могут быть тем же самым, которые использовались, чтобы инициализировать этот шифр, или могут содержать комбинацию и случайных значений параметра по умолчанию, используемых базовой реализацией шифра, если этот шифр требует параметров алгоритма, но не был инициализирован ни с кем.
    
    Возвраты:
    параметры, используемые с этим шифром, или нулем, если этот шифр не использует параметров.
  - engineInit
```
protected abstract void engineInit(int opmode,
              Key key,
              SecureRandom random)
                            throws InvalidKeyException
```
    Инициализирует этот шифр с ключом и источником случайности.
    Шифр инициализируется для одной из следующих четырех операций: шифрование, дешифрование, ключевое обертывание или ключевое разворачивание, в зависимости от значения opmode.
    Если этот шифр требует каких-либо параметров алгоритма, которые не могут быть получены из данного key, базовая реализация шифра, как предполагается, генерирует обязательные параметры самостоятельно (использующий специфичное для провайдера значение по умолчанию или случайные значения), если это инициализируется для шифрования или ключевого обертывания, и повышения InvalidKeyException если это инициализируется для дешифрования или ключевого разворачивания. Сгенерированные параметры могут быть получены, используя engineGetParameters или engineGetIV (если параметр является IV).
    Если этот шифр потребует параметров алгоритма, которые не могут быть получены из входных параметров, и нет никаких разумных специфичных для провайдера значений по умолчанию, то инициализация обязательно перестанет работать.
    Если этот шифр (включая его базовую обратную связь или дополнительную схему) потребует каких-либо случайных байтов (например, для генерации параметра), то это получит их от random.
    Отметьте, что, когда объект Шифра инициализируется, он теряет все ранее полученное состояние. Другими словами инициализация Шифра эквивалентна созданию нового экземпляра того Шифра и инициализации этого.
    
    Параметры:
    opmode - режим работы этого шифра (это - одно из следующего: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)
    key - ключ шифрования
    random - источник случайности
    
    Броски:
    
    InvalidKeyException - если данный ключ является несоответствующим для того, чтобы инициализировать этот шифр, или требует параметров алгоритма, которые не могут быть определены от данного ключа.
  - engineInit
```
protected abstract void engineInit(int opmode,
              Key key,
              AlgorithmParameterSpec params,
              SecureRandom random)
                            throws InvalidKeyException,
                                   InvalidAlgorithmParameterException
```
    Инициализирует этот шифр с ключом, ряд параметров алгоритма, и источника случайности.
    Шифр инициализируется для одной из следующих четырех операций: шифрование, дешифрование, ключевое обертывание или ключевое разворачивание, в зависимости от значения opmode.
    Если этот шифр требует каких-либо параметров алгоритма и params нуль, базовая реализация шифра, как предполагается, генерирует обязательные параметры самостоятельно (использующий специфичное для провайдера значение по умолчанию или случайные значения), если это инициализируется для шифрования или ключевого обертывания, и повышения InvalidAlgorithmParameterException если это инициализируется для дешифрования или ключевого разворачивания. Сгенерированные параметры могут быть получены, используя engineGetParameters или engineGetIV (если параметр является IV).
    Если этот шифр потребует параметров алгоритма, которые не могут быть получены из входных параметров, и нет никаких разумных специфичных для провайдера значений по умолчанию, то инициализация обязательно перестанет работать.
    Если этот шифр (включая его базовую обратную связь или дополнительную схему) потребует каких-либо случайных байтов (например, для генерации параметра), то это получит их от random.
    Отметьте, что, когда объект Шифра инициализируется, он теряет все ранее полученное состояние. Другими словами инициализация Шифра эквивалентна созданию нового экземпляра того Шифра и инициализации этого.
    
    Параметры:
    opmode - режим работы этого шифра (это - одно из следующего: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)
    key - ключ шифрования
    params - параметры алгоритма
    random - источник случайности
    
    Броски:
    
    InvalidKeyException - если данный ключ является несоответствующим для того, чтобы инициализировать этот шифр
    
    InvalidAlgorithmParameterException - если данные параметры алгоритма являются несоответствующими для этого шифра, или если этот шифр требует параметров алгоритма и params нуль.
  - engineInit
```
protected abstract void engineInit(int opmode,
              Key key,
              AlgorithmParameters params,
              SecureRandom random)
                            throws InvalidKeyException,
                                   InvalidAlgorithmParameterException
```
    Инициализирует этот шифр с ключом, ряд параметров алгоритма, и источника случайности.
    Шифр инициализируется для одной из следующих четырех операций: шифрование, дешифрование, ключевое обертывание или ключевое разворачивание, в зависимости от значения opmode.
    Если этот шифр требует каких-либо параметров алгоритма и params нуль, базовая реализация шифра, как предполагается, генерирует обязательные параметры самостоятельно (использующий специфичное для провайдера значение по умолчанию или случайные значения), если это инициализируется для шифрования или ключевого обертывания, и повышения InvalidAlgorithmParameterException если это инициализируется для дешифрования или ключевого разворачивания. Сгенерированные параметры могут быть получены, используя engineGetParameters или engineGetIV (если параметр является IV).
    Если этот шифр потребует параметров алгоритма, которые не могут быть получены из входных параметров, и нет никаких разумных специфичных для провайдера значений по умолчанию, то инициализация обязательно перестанет работать.
    Если этот шифр (включая его базовую обратную связь или дополнительную схему) потребует каких-либо случайных байтов (например, для генерации параметра), то это получит их от random.
    Отметьте, что, когда объект Шифра инициализируется, он теряет все ранее полученное состояние. Другими словами инициализация Шифра эквивалентна созданию нового экземпляра того Шифра и инициализации этого.
    
    Параметры:
    opmode - режим работы этого шифра (это - одно из следующего: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)
    key - ключ шифрования
    params - параметры алгоритма
    random - источник случайности
    
    Броски:
    
    InvalidKeyException - если данный ключ является несоответствующим для того, чтобы инициализировать этот шифр
    
    InvalidAlgorithmParameterException - если данные параметры алгоритма являются несоответствующими для этого шифра, или если этот шифр требует параметров алгоритма и params нуль.
  - engineUpdate
```
protected abstract byte[] engineUpdate(byte[] input,
                  int inputOffset,
                  int inputLen)
```
    Продолжает шифрование многократной части или работу дешифрования (в зависимости от того, как этот шифр был инициализирован), обрабатывая другую часть данных.
    Первое inputLen байты в input буфер, запускающийся в inputOffset включительно, обрабатываются, и результат сохранен в новом буфере.
    
    Параметры:
    input - входной буфер
    inputOffset - смещение в input где ввод запускается
    inputLen - входная длина
    
    Возвраты:
    новый буфер с результатом, или нуль, если базовый шифр является блочным шифром и входными данными, слишком короток, чтобы привести к новому блоку.
  - engineUpdate
```
protected abstract int engineUpdate(byte[] input,
               int inputOffset,
               int inputLen,
               byte[] output,
               int outputOffset)
                             throws ShortBufferException
```
    Продолжает шифрование многократной части или работу дешифрования (в зависимости от того, как этот шифр был инициализирован), обрабатывая другую часть данных.
    Первое inputLen байты в input буфер, запускающийся в inputOffset включительно, обрабатываются, и результат сохранен в output буфер, запускающийся в outputOffset включительно.
    Если output буфер является слишком маленьким, чтобы содержать результат, a ShortBufferException бросается.
    
    Параметры:
    input - входной буфер
    inputOffset - смещение в input где ввод запускается
    inputLen - входная длина
    output - буфер для результата
    outputOffset - смещение в output где результат сохранен
    
    Возвраты:
    число байтов, сохраненных в output
    
    Броски:
    
    ShortBufferException - если данный буфер вывода является слишком небольшим, чтобы содержать результат
  - engineUpdate
```
protected int engineUpdate(ByteBuffer input,
               ByteBuffer output)
                    throws ShortBufferException
```
    Продолжает шифрование многократной части или работу дешифрования (в зависимости от того, как этот шифр был инициализирован), обрабатывая другую часть данных.
    Все input.remaining() байты, запускающиеся в input.position() обрабатываются. Результат сохранен в буфере вывода. По возврату входная буферная позиция будет равна своему пределу; его предел не будет изменяться. Позиция буфера вывода будет совершенствоваться n, где n является значением, возвращенным этим методом; предел буфера вывода не будет изменяться.
    Если output.remaining() байты недостаточны, чтобы содержать результат, a ShortBufferException бросается.
    Подклассы должны рассмотреть переопределение этого метода, если они могут обработать ByteBuffers более эффективно чем байтовые массивы.
    
    Параметры:
    input - ввод ByteBuffer
    output - вывод ByteByffer
    
    Возвраты:
    число байтов, сохраненных в output
    
    Броски:
    
    ShortBufferException - если есть недостаточное пространство в буфере вывода
    
    NullPointerException - если любой параметр null
    С тех пор:
    
    1.5
  - engineDoFinal
```
protected abstract byte[] engineDoFinal(byte[] input,
                   int inputOffset,
                   int inputLen)
                                 throws IllegalBlockSizeException,
                                        BadPaddingException
```
    Шифрует или дешифрует данные в работе единственной части, или заканчивает работу многократной части. Данные шифруются или дешифровываются, в зависимости от того, как этот шифр был инициализирован.
    Первое inputLen байты в input буфер, запускающийся в inputOffset включительно, и любые входные байты, которые, возможно, были буферизованы во время предыдущего update работа, обрабатываются, с дополнением (если требующийся) быть примененным. Если режим AEAD, такой как GCM/CCM используется, тег аутентификации добавляется в случае шифрования, или проверяется в случае дешифрования. Результат сохранен в новом буфере.
    После окончания этот метод сбрасывает этот объект шифра к состоянию, в котором это было когда ранее инициализировано через звонок engineInit. Таким образом, объект сбрасывается и доступен, чтобы зашифровать или дешифровать (в зависимости от режима работы, который был определен в звонке engineInit) больше данных.
    Отметьте: если какое-либо исключение выдается, этот объект шифра, возможно, должен быть сброшен прежде, чем это сможет использоваться снова.
    
    Параметры:
    input - входной буфер
    inputOffset - смещение в input где ввод запускается
    inputLen - входная длина
    
    Возвраты:
    новый буфер с результатом
    
    Броски:
    
    IllegalBlockSizeException - если этот шифр является блочным шифром, никакое дополнение не требовали (только в режиме шифрования), и длина общих затрат данных, обработанных этим шифром, не является кратным числом размера блока; или если этот алгоритм шифрования неспособен обработать входные обеспеченные данные.
    
    BadPaddingException - если этот шифр находится в режиме дешифрования, и (un), дополнение требовали, но дешифрованные данные не ограничиваются соответствующими дополнительными байтами
    
    AEADBadTagException - если этот шифр дешифрует в режиме AEAD (таком как GCM/CCM), и полученный тег аутентификации не соответствует расчетное значение
  - engineDoFinal
```
protected abstract int engineDoFinal(byte[] input,
                int inputOffset,
                int inputLen,
                byte[] output,
                int outputOffset)
                              throws ShortBufferException,
                                     IllegalBlockSizeException,
                                     BadPaddingException
```
    Шифрует или дешифрует данные в работе единственной части, или заканчивает работу многократной части. Данные шифруются или дешифровываются, в зависимости от того, как этот шифр был инициализирован.
    Первое inputLen байты в input буфер, запускающийся в inputOffset включительно, и любые входные байты, которые, возможно, были буферизованы во время предыдущего update работа, обрабатываются, с дополнением (если требующийся) быть примененным. Если режим AEAD, такой как GCM/CCM используется, тег аутентификации добавляется в случае шифрования, или проверяется в случае дешифрования. Результат сохранен в output буфер, запускающийся в outputOffset включительно.
    Если output буфер является слишком маленьким, чтобы содержать результат, a ShortBufferException бросается.
    После окончания этот метод сбрасывает этот объект шифра к состоянию, в котором это было когда ранее инициализировано через звонок engineInit. Таким образом, объект сбрасывается и доступен, чтобы зашифровать или дешифровать (в зависимости от режима работы, который был определен в звонке engineInit) больше данных.
    Отметьте: если какое-либо исключение выдается, этот объект шифра, возможно, должен быть сброшен прежде, чем это сможет использоваться снова.
    
    Параметры:
    input - входной буфер
    inputOffset - смещение в input где ввод запускается
    inputLen - входная длина
    output - буфер для результата
    outputOffset - смещение в output где результат сохранен
    
    Возвраты:
    число байтов, сохраненных в output
    
    Броски:
    
    IllegalBlockSizeException - если этот шифр является блочным шифром, никакое дополнение не требовали (только в режиме шифрования), и длина общих затрат данных, обработанных этим шифром, не является кратным числом размера блока; или если этот алгоритм шифрования неспособен обработать входные обеспеченные данные.
    
    ShortBufferException - если данный буфер вывода является слишком небольшим, чтобы содержать результат
    
    BadPaddingException - если этот шифр находится в режиме дешифрования, и (un), дополнение требовали, но дешифрованные данные не ограничиваются соответствующими дополнительными байтами
    
    AEADBadTagException - если этот шифр дешифрует в режиме AEAD (таком как GCM/CCM), и полученный тег аутентификации не соответствует расчетное значение
  - engineDoFinal
```
protected int engineDoFinal(ByteBuffer input,
                ByteBuffer output)
                     throws ShortBufferException,
                            IllegalBlockSizeException,
                            BadPaddingException
```
    Шифрует или дешифрует данные в работе единственной части, или заканчивает работу многократной части. Данные шифруются или дешифровываются, в зависимости от того, как этот шифр был инициализирован.
    Все input.remaining() байты, запускающиеся в input.position() обрабатываются. Если режим AEAD, такой как GCM/CCM используется, тег аутентификации добавляется в случае шифрования, или проверяется в случае дешифрования. Результат сохранен в буфере вывода. По возврату входная буферная позиция будет равна своему пределу; его предел не будет изменяться. Позиция буфера вывода будет совершенствоваться n, где n является значением, возвращенным этим методом; предел буфера вывода не будет изменяться.
    Если output.remaining() байты недостаточны, чтобы содержать результат, a ShortBufferException бросается.
    После окончания этот метод сбрасывает этот объект шифра к состоянию, в котором это было когда ранее инициализировано через звонок engineInit. Таким образом, объект сбрасывается и доступен, чтобы зашифровать или дешифровать (в зависимости от режима работы, который был определен в звонке engineInit) больше данных.
    Отметьте: если какое-либо исключение выдается, этот объект шифра, возможно, должен быть сброшен прежде, чем это сможет использоваться снова.
    Подклассы должны рассмотреть переопределение этого метода, если они могут обработать ByteBuffers более эффективно чем байтовые массивы.
    
    Параметры:
    input - ввод ByteBuffer
    output - вывод ByteByffer
    
    Возвраты:
    число байтов, сохраненных в output
    
    Броски:
    
    IllegalBlockSizeException - если этот шифр является блочным шифром, никакое дополнение не требовали (только в режиме шифрования), и длина общих затрат данных, обработанных этим шифром, не является кратным числом размера блока; или если этот алгоритм шифрования неспособен обработать входные обеспеченные данные.
    
    ShortBufferException - если есть недостаточное пространство в буфере вывода
    
    BadPaddingException - если этот шифр находится в режиме дешифрования, и (un), дополнение требовали, но дешифрованные данные не ограничиваются соответствующими дополнительными байтами
    
    AEADBadTagException - если этот шифр дешифрует в режиме AEAD (таком как GCM/CCM), и полученный тег аутентификации не соответствует расчетное значение
    
    NullPointerException - если любой параметр null
    С тех пор:
    
    1.5
  - engineWrap
```
protected byte[] engineWrap(Key key)
                     throws IllegalBlockSizeException,
                            InvalidKeyException
```
    Оберните ключ.
    Этот конкретный метод был добавлен к этому ранее определенному абстрактному классу. (Для назад совместимости это не может быть абстрактно.) Это может быть переопределено провайдером, чтобы обернуть ключ. Такое переопределение, как ожидают, бросит IllegalBlockSizeException или InvalidKeyException (при указанных обстоятельствах), если данный ключ не может быть обернут. Если этот метод не переопределяется, он всегда бросает UnsupportedOperationException.
    
    Параметры:
    key - ключ, который будет обернут.
    
    Возвраты:
    обернутый ключ.
    
    Броски:
    
    IllegalBlockSizeException - если этот шифр является блочным шифром, никакое дополнение не требовали, и продолжительность кодирования ключа, который будет обернут, не является кратным числом размера блока.
    
    InvalidKeyException - если это невозможно или опасно обернуть ключ с этим шифром (например, аппаратные средства, защищенный ключ передают к шифру только для программного обеспечения).
  - engineUnwrap
```
protected Key engineUnwrap(byte[] wrappedKey,
               String wrappedKeyAlgorithm,
               int wrappedKeyType)
                    throws InvalidKeyException,
                           NoSuchAlgorithmException
```
    Разверните ранее обернутый ключ.
    Этот конкретный метод был добавлен к этому ранее определенному абстрактному классу. (Для назад совместимости это не может быть абстрактно.) Это может быть переопределено провайдером, чтобы развернуть ранее обернутый ключ. Такое переопределение, как ожидают, бросит InvalidKeyException, если данный обернутый ключ не может быть развернут. Если этот метод не переопределяется, он всегда бросает UnsupportedOperationException.
    
    Параметры:
    wrappedKey - ключ, который будет развернут.
    wrappedKeyAlgorithm - алгоритм связался с обернутым ключом.
    wrappedKeyType - тип обернутого ключа. Это - один из SECRET_KEY, PRIVATE_KEY, или PUBLIC_KEY.
    
    Возвраты:
    развернутый ключ.
    
    Броски:
    
    NoSuchAlgorithmException - если никакие установленные провайдеры не могут создать ключи типа wrappedKeyType для wrappedKeyAlgorithm.
    
    InvalidKeyException - если wrappedKey не представляет обернутый ключ типа wrappedKeyType для wrappedKeyAlgorithm.
  - engineGetKeySize
```
protected int engineGetKeySize(Key key)
                        throws InvalidKeyException
```
    Возвращает размер ключа данного ключевого объекта в битах.
    Этот конкретный метод был добавлен к этому ранее определенному абстрактному классу. Это бросает UnsupportedOperationException если это не переопределяется провайдером.
    
    Параметры:
    key - ключевой объект.
    
    Возвраты:
    размер ключа данного ключевого объекта.
    
    Броски:
    
    InvalidKeyException - если key недопустимо.
  - engineUpdateAAD
```
protected void engineUpdateAAD(byte[] src,
                   int offset,
                   int len)
```
    Продолжает многослойное обновление Дополнительных Данных Аутентификации (AAD), используя подмножество обеспеченного буфера.
    Звонки в этот метод обеспечивают AAD для шифра, работая в режимах, таких как AEAD (GCM/CCM). Если этот шифр работает или в GCM или в режиме CCM, весь AAD должен быть предоставлен перед начинающимися операциями на шифрованном тексте (через update и doFinal методы).
    
    Параметры:
    src - буфер, содержащий AAD
    offset - смещение в src где ввод AAD запускается
    len - число байтов AAD
    
    Броски:
    
    IllegalStateException - если этот шифр находится в неправильном состоянии (например, не был инициализирован), не принимает AAD, или работая или в GCM или в режиме CCM и одном из update методы уже вызвали для активной работы шифрования/дешифрования
    
    UnsupportedOperationException - если этот метод не был переопределен реализацией
    С тех пор:
    
    1.7
  - engineUpdateAAD
```
protected void engineUpdateAAD(ByteBuffer src)
```
    Продолжает многослойное обновление Дополнительных Данных Аутентификации (AAD).
    Звонки в этот метод обеспечивают AAD для шифра, работая в режимах, таких как AEAD (GCM/CCM). Если этот шифр работает или в GCM или в режиме CCM, весь AAD должен быть предоставлен перед начинающимися операциями на шифрованном тексте (через update и doFinal методы).
    Все src.remaining() байты, запускающиеся в src.position() обрабатываются. По возврату входная буферная позиция будет равна своему пределу; его предел не будет изменяться.
    
    Параметры:
    src - буфер, содержащий AAD
    
    Броски:
    
    IllegalStateException - если этот шифр находится в неправильном состоянии (например, не был инициализирован), не принимает AAD, или работая или в GCM или в режиме CCM и одном из update методы уже вызвали для активной работы шифрования/дешифрования
    
    UnsupportedOperationException - если этот метод не был переопределен реализацией
    С тех пор:
    
    1.7

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

Класс CipherSpi

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

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

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

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

CipherSpi

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

engineSetMode

engineSetPadding

engineGetBlockSize

engineGetOutputSize

engineGetIV

engineGetParameters

engineInit

engineInit

engineInit

engineUpdate

engineUpdate

engineUpdate

engineDoFinal

engineDoFinal

engineDoFinal

engineWrap

engineUnwrap

engineGetKeySize

engineUpdateAAD

engineUpdateAAD