Класс Cipher

public static final int ENCRYPT_MODE

См. также:

• Значения констант полей

public static final int DECRYPT_MODE

См. также:

• Значения констант полей

public static final int WRAP_MODE

См. также:

• Значения констант полей

public static final int UNWRAP_MODE

См. также:

• Значения констант полей

public static final int PUBLIC_KEY

См. также:

• Значения констант полей

public static final int PRIVATE_KEY

См. также:

• Значения констант полей

public static final int SECRET_KEY

См. также:

• Значения констант полей

protected Cipher(CipherSpi cipherSpi, Provider provider, String transformation)

Параметры:

cipherSpi — делегат

provider — поставщик

transformation — преобразование

Исключения:

NullPointerException — если provider равен null

IllegalArgumentException — если переданные аргументы признаны недопустимыми для создания объекта Cipher

public static final Cipher getInstance(String transformation) throws NoSuchAlgorithmException, NoSuchPaddingException

Примечание к API:

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

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

Эталонная реализация JDK дополнительно использует свойство jdk.security.provider.preferred Security, чтобы определить предпочтительный порядок поставщиков для указанного алгоритма. Он может отличаться от порядка поставщиков, возвращаемых методом Security.getProviders(). Сведения о значениях преобразований по умолчанию, используемых поставщиками JDK, см. также в разделе «Преобразования Cipher» документа Поставщики JDK.

Параметры:

transformation — имя преобразования, например AES/CBC/PKCS5Padding. Сведения о стандартных именах преобразований см. в разделе Cipher спецификации стандартных имен алгоритмов Java Security.

Возвращает:

объект Cipher, реализующий запрошенное преобразование

Исключения:

NoSuchAlgorithmException — если transformation равен null, пуст, имеет недопустимый формат или ни один поставщик не поддерживает реализацию CipherSpi для указанного алгоритма

NoSuchPaddingException — если transformation содержит недоступную схему дополнения

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

• Стандартные имена алгоритмов Java Security

См. также:

• Provider

public static final Cipher getInstance(String transformation, String provider) throws NoSuchAlgorithmException, NoSuchProviderException, NoSuchPaddingException

Примечание к API:

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

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

Сведения о значениях преобразований по умолчанию, используемых поставщиками JDK, см. в разделе «Преобразования Cipher» документа Поставщики JDK.

Параметры:

transformation — имя преобразования, например AES/CBC/PKCS5Padding. Сведения о стандартных именах преобразований см. в разделе Cipher спецификации стандартных имен алгоритмов Java Security.

provider — имя поставщика

Возвращает:

объект Cipher, реализующий запрошенное преобразование

Исключения:

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

NoSuchAlgorithmException — если transformation равен null, пуст, имеет недопустимый формат или указанный поставщик не предоставляет реализацию CipherSpi для заданного алгоритма

NoSuchPaddingException — если transformation содержит недоступную схему дополнения

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

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

• Стандартные имена алгоритмов Java Security

См. также:

• Provider

public static final Cipher getInstance(String transformation, Provider provider) throws NoSuchAlgorithmException, NoSuchPaddingException

Примечание к API:

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

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

Сведения о значениях преобразований по умолчанию, используемых поставщиками JDK, см. в разделе «Преобразования Cipher» документа Поставщики JDK.

Параметры:

transformation — имя преобразования, например AES/CBC/PKCS5Padding. Сведения о стандартных именах преобразований см. в разделе Cipher спецификации стандартных имен алгоритмов Java Security.

provider — поставщик

Возвращает:

объект Cipher, реализующий запрошенное преобразование

Исключения:

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

NoSuchAlgorithmException — если transformation равен null, пуст, имеет недопустимый формат или указанный объект provider не предоставляет реализацию CipherSpi для заданного алгоритма

NoSuchPaddingException — если transformation содержит недоступную схему дополнения

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

• Стандартные имена алгоритмов Java Security

См. также:

• Provider

public final Provider getProvider()

Возвращает:

поставщика этого объекта Cipher

public final String getAlgorithm()

Возвращает:

имя алгоритма этого объекта Cipher

public final int getBlockSize()

Возвращает:

размер блока (в байтах) или 0, если этот шифр не является блочным

public final int getOutputSize(int inputLen)

Параметры:

inputLen — длина входных данных (в байтах)

Возвращает:

необходимый размер буфера вывода (в байтах)

Исключения:

IllegalStateException — если объект Cipher находится в недопустимом состоянии (например, еще не инициализирован)

public final byte[] getIV()

Возвращает:

вектор инициализации в новом буфере или null, если этот шифр не использует IV либо IV еще не задан.

public final AlgorithmParameters getParameters()

Возвращает:

параметры, использованные с этим шифром, или null

public final ExemptionMechanism getExemptionMechanism()

Возвращает:

объект механизма исключений, использованный с этим объектом Cipher, или null, если этот объект Cipher не использует механизм исключений.

public final void init(int opmode, Key key) throws InvalidKeyException

Параметры:

opmode — режим работы этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ

Исключения:

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

UnsupportedOperationException — если opmode равен WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не реализует этот режим

InvalidParameterException — если opmode не входит в число распознаваемых значений

public final void init(int opmode, Key key, SecureRandom random) throws InvalidKeyException

Параметры:

opmode — режим работы этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ шифрования

random — источник случайных данных

Исключения:

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

UnsupportedOperationException — если opmode равен WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не реализует этот режим

InvalidParameterException — если opmode не входит в число распознаваемых значений

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

Параметры:

opmode — режим работы этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ шифрования

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

Исключения:

InvalidKeyException — если заданный ключ не подходит для инициализации этого шифра или его размер превышает максимально допустимый (согласно настроенным файлам политик юрисдикции)

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

UnsupportedOperationException — если opmode равен WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не реализует этот режим

InvalidParameterException — если opmode не входит в число распознаваемых значений

public final void init(int opmode, Key key, AlgorithmParameterSpec params, SecureRandom random) throws InvalidKeyException, InvalidAlgorithmParameterException

Параметры:

opmode — режим работы этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ шифрования

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

random — источник случайных данных

Исключения:

InvalidKeyException — если заданный ключ не подходит для инициализации этого шифра или его размер превышает максимально допустимый (согласно настроенным файлам политик юрисдикции)

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

UnsupportedOperationException — если opmode равен WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не реализует этот режим

InvalidParameterException — если opmode не входит в число распознаваемых значений

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

Параметры:

opmode — режим операции этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ шифрования

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

Исключения:

InvalidKeyException — если указанный ключ не подходит для инициализации этого шифра или его размер превышает максимально допустимый (согласно настроенным файлам политики юрисдикции).

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

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не соответствует ни одному из распознаваемых значений

public final void init(int opmode, Key key, AlgorithmParameters params, SecureRandom random) throws InvalidKeyException, InvalidAlgorithmParameterException

Параметры:

opmode — режим операции этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

key — ключ шифрования

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

random — источник случайных данных

Исключения:

InvalidKeyException — если указанный ключ не подходит для инициализации этого шифра или его размер превышает максимально допустимый (согласно настроенным файлам политики юрисдикции)

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

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не соответствует ни одному из распознаваемых значений

public final void init(int opmode, Certificate certificate) throws InvalidKeyException

Параметры:

opmode — режим операции этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

certificate — сертификат

Исключения:

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

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не соответствует ни одному из распознаваемых значений

public final void init(int opmode, Certificate certificate, SecureRandom random) throws InvalidKeyException

Параметры:

opmode — режим операции этого объекта Cipher (одно из следующих значений: ENCRYPT_MODE, DECRYPT_MODE, WRAP_MODE или UNWRAP_MODE)

certificate — сертификат

random — источник случайных данных

Исключения:

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

UnsupportedOperationException — если opmode имеет значение WRAP_MODE или UNWRAP_MODE, но базовая реализация CipherSpi не поддерживает этот режим

InvalidParameterException — если opmode не соответствует ни одному из распознаваемых значений

public final byte[] update(byte[] input)

Параметры:

input — входной буфер

Возвращает:

новый буфер с результатом или null, если этот шифр является блочным и входных данных недостаточно для создания нового блока

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

public final byte[] update(byte[] input, int inputOffset, int inputLen)

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

Возвращает:

новый буфер с результатом или null, если этот шифр является блочным и входных данных недостаточно для создания нового блока.

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

public final int update(byte[] input, int inputOffset, int inputLen, byte[] output) throws ShortBufferException

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

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

Возвращает:

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

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

ShortBufferException — если указанный буфер вывода слишком мал для хранения результата

public final int update(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset) throws ShortBufferException

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

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

outputOffset — смещение в output, по которому сохраняется результат

Возвращает:

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

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

ShortBufferException — если указанный буфер вывода слишком мал для хранения результата

public final int update(ByteBuffer input, ByteBuffer output) throws ShortBufferException

Параметры:

input — входной ByteBuffer

output — выходной ByteByffer

Возвращает:

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

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

IllegalArgumentException — если входной и выходной буферы являются одним и тем же объектом

ReadOnlyBufferException — если выходной буфер доступен только для чтения

ShortBufferException — если в выходном буфере недостаточно места

Начиная с версии:

1.5

public final byte[] doFinal() throws IllegalBlockSizeException, BadPaddingException

Возвращает:

новый буфер с результатом

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

IllegalBlockSizeException — если этот шифр является блочным, дополнение не запрошено (только в режиме шифрования), а общая длина обработанных этим шифром входных данных не кратна размеру блока; либо если этот алгоритм шифрования не может обработать предоставленные входные данные.

BadPaddingException — если этот объект Cipher находится в режиме расшифрования, запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher расшифровывает данные в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final int doFinal(byte[] output, int outputOffset) throws IllegalBlockSizeException, ShortBufferException, BadPaddingException

Параметры:

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

outputOffset — смещение в output, по которому сохраняется результат

Возвращает:

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

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

IllegalBlockSizeException — если этот шифр является блочным, дополнение не запрошено (только в режиме шифрования), а общая длина обработанных этим шифром входных данных не кратна размеру блока; либо если этот алгоритм шифрования не может обработать предоставленные входные данные.

ShortBufferException — если указанный буфер вывода слишком мал для хранения результата

BadPaddingException — если этот объект Cipher находится в режиме расшифрования, запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher расшифровывает данные в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final byte[] doFinal(byte[] input) throws IllegalBlockSizeException, BadPaddingException

Параметры:

input — входной буфер

Возвращает:

новый буфер с результатом

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

IllegalBlockSizeException — если этот шифр является блочным, дополнение не запрошено (только в режиме шифрования), а общая длина обработанных этим шифром входных данных не кратна размеру блока; либо если этот алгоритм шифрования не может обработать предоставленные входные данные.

BadPaddingException — если этот объект Cipher находится в режиме расшифрования, запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher расшифровывает данные в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final byte[] doFinal(byte[] input, int inputOffset, int inputLen) throws IllegalBlockSizeException, BadPaddingException

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

Возвращает:

новый буфер с результатом

Исключения:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

IllegalBlockSizeException — если этот шифр является блочным, дополнение не запрошено (только в режиме шифрования), а общая длина обработанных этим шифром входных данных не кратна размеру блока; либо если этот алгоритм шифрования не может обработать предоставленные входные данные.

BadPaddingException — если этот объект Cipher находится в режиме расшифрования, запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher расшифровывает данные в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final int doFinal(byte[] input, int inputOffset, int inputLen, byte[] output) throws ShortBufferException, IllegalBlockSizeException, BadPaddingException

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

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

Возвращает:

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

Вызывает:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

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

ShortBufferException — если предоставленный буфер вывода слишком мал для хранения результата

BadPaddingException — если этот объект Cipher находится в режиме расшифрования и было запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher расшифровывает данные в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final int doFinal(byte[] input, int inputOffset, int inputLen, byte[] output, int outputOffset) throws ShortBufferException, IllegalBlockSizeException, BadPaddingException

Параметры:

input — входной буфер

inputOffset — смещение в input, с которого начинаются входные данные

inputLen — длина входных данных

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

outputOffset — смещение в output, по которому сохраняется результат

Возвращает:

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

Вызывает:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

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

ShortBufferException — если предоставленный буфер вывода слишком мал для хранения результата

BadPaddingException — если этот объект Cipher находится в режиме расшифрования и было запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher расшифровывает данные в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

public final int doFinal(ByteBuffer input, ByteBuffer output) throws ShortBufferException, IllegalBlockSizeException, BadPaddingException

Параметры:

input — входной ByteBuffer

output — выходной ByteBuffer

Возвращает:

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

Вызывает:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE)

IllegalArgumentException — если входной и выходной буферы являются одним и тем же объектом

ReadOnlyBufferException — если буфер вывода доступен только для чтения

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

ShortBufferException — если в буфере вывода недостаточно места

BadPaddingException — если этот объект Cipher находится в режиме расшифрования и было запрошено (снятие) дополнения, но расшифрованные данные не ограничены соответствующими байтами дополнения

AEADBadTagException — если этот объект Cipher расшифровывает данные в режиме AEAD (например, GCM/CCM), а полученный тег аутентификации не совпадает с вычисленным значением

Начиная с:

1.5

public final byte[] wrap(Key key) throws IllegalBlockSizeException, InvalidKeyException

Параметры:

key — ключ для упаковки

Возвращает:

упакованный ключ

Вызывает:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не был инициализирован или не находится в режиме WRAP_MODE)

IllegalBlockSizeException — если данный шифр является блочным шифром, дополнение не было запрошено, а длина кодированного представления упаковываемого ключа не кратна размеру блока

InvalidKeyException — если упаковать ключ с помощью данного шифра невозможно или небезопасно (например, если программному шифру передан ключ, защищённый аппаратными средствами)

UnsupportedOperationException — если соответствующий метод в CipherSpi не поддерживается

public final Key unwrap(byte[] wrappedKey, String wrappedKeyAlgorithm, int wrappedKeyType) throws InvalidKeyException, NoSuchAlgorithmException

Параметры:

wrappedKey — ключ для распаковки

wrappedKeyAlgorithm — алгоритм, связанный с упакованным ключом

wrappedKeyType — тип упакованного ключа. Должен быть одним из следующих: SECRET_KEY, PRIVATE_KEY или PUBLIC_KEY

Возвращает:

распакованный ключ

Вызывает:

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не был инициализирован или не находится в режиме UNWRAP_MODE)

NoSuchAlgorithmException — если ни один установленный поставщик не может создавать ключи типа wrappedKeyType для wrappedKeyAlgorithm

InvalidKeyException — если wrappedKey не представляет собой упакованный ключ типа wrappedKeyType для wrappedKeyAlgorithm

UnsupportedOperationException — если соответствующий метод в CipherSpi не поддерживается

public static final int getMaxAllowedKeyLength(String transformation) throws NoSuchAlgorithmException

Параметры:

transformation — преобразование шифра

Возвращает:

максимальную длину ключа в битах или Integer.MAX_VALUE

Вызывает:

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

NoSuchAlgorithmException — если transformation не является допустимым преобразованием, то есть не имеет вид «algorithm» или «algorithm/mode/padding»

Начиная с:

1.5

public static final AlgorithmParameterSpec getMaxAllowedParameterSpec(String transformation) throws NoSuchAlgorithmException

Параметры:

transformation — преобразование шифра

Возвращает:

объект {code AlgorithmParameterSpec}, содержащий максимальное значение, или null

Вызывает:

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

NoSuchAlgorithmException — если transformation не является допустимым преобразованием, то есть не имеет вид «algorithm» или «algorithm/mode/padding»

Начиная с:

1.5

public final void updateAAD(byte[] src)

Параметры:

src — буфер, содержащий дополнительные данные аутентификации

Вызывает:

IllegalArgumentException — если байтовый массив src равен null

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE), не принимает AAD либо работает в режиме GCM или CCM и для текущей операции шифрования/расшифрования уже был вызван один из методов update

UnsupportedOperationException — если соответствующий метод в CipherSpi не переопределён реализацией

Начиная с:

1.7

public final void updateAAD(byte[] src, int offset, int len)

Параметры:

src — буфер, содержащий AAD

offset — смещение в src, с которого начинаются входные данные AAD

len — количество байтов AAD

Вызывает:

IllegalArgumentException — если байтовый массив src равен null, либо offset или length меньше 0, либо сумма offset и len превышает длину байтового массива src

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE), не принимает AAD либо работает в режиме GCM или CCM и для текущей операции шифрования/расшифрования уже был вызван один из методов update

UnsupportedOperationException — если соответствующий метод в CipherSpi не переопределён реализацией

Начиная с:

1.7

public final void updateAAD(ByteBuffer src)

Параметры:

src — буфер, содержащий AAD

Вызывает:

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

IllegalStateException — если этот объект Cipher находится в неверном состоянии (например, не был инициализирован или не находится в режиме ENCRYPT_MODE или DECRYPT_MODE), не принимает AAD либо работает в режиме GCM или CCM и для текущей операции шифрования/расшифрования уже был вызван один из методов update

UnsupportedOperationException — если соответствующий метод в CipherSpi не переопределён реализацией

Начиная с:

1.7

public String toString()

Переопределяет:

toString в классе Object

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

Эта реализация возвращает объект String, содержащий преобразование, режим и поставщика этого объекта Cipher. Точный формат String не определён и может измениться.

Возвращает:

строку, описывающую этот объект Cipher