Класс Cipher

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

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

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

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

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

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

Этот вызов учитывает любые необработанные (буферизованные) данные из предыдущего вызова update, заполнение и тегирование AEAD.

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

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

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

Шифр инициализируется для одной из следующих четырёх операций: шифрование, дешифрование, обертывание ключа или разворачивание ключа, в зависимости от значения opmode.

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

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

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

Обратите внимание, что при инициализации объекта Cipher, он теряет все ранее полученное состояние. Другими словами, инициализация Cipher эквивалентна созданию нового экземпляра этого Cipher и его инициализации.

Шифр инициализируется для одной из следующих четырёх операций: шифрование, дешифрование, обертывание ключа или разворачивание ключа, в зависимости от значения opmode.

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

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

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

Обратите внимание, что при инициализации объекта Cipher, он теряет все ранее полученное состояние. Другими словами, инициализация Cipher эквивалентна созданию нового экземпляра этого Cipher и его инициализации.

Шифр инициализируется для одной из следующих четырёх операций: шифрование, дешифрование, обертывание ключа или разворачивание ключа, в зависимости от значения opmode.

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

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

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

Обратите внимание, что при инициализации объекта Cipher, он теряет все ранее полученное состояние. Другими словами, инициализация Cipher эквивалентна созданию нового экземпляра этого Cipher и его инициализации.

Шифр инициализируется для одной из следующих четырёх операций: шифрования, дешифрования, обертывания ключа или распаковки ключа, в зависимости от значения opmode.

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

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

Если шифру (включая базовый механизм обратной связи или заполнения) требуются случайные байты (например, для генерации параметров), они будут взяты из random.

Обратите внимание, что при инициализации объекта Cipher он теряет все ранее полученные состояния. Другими словами, инициализация Cipher эквивалентна созданию нового экземпляра этого Cipher и его инициализации.

Шифр инициализируется для одной из следующих четырёх операций: шифрования, дешифрования, обертывания ключа или распаковки ключа, в зависимости от значения opmode.

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

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

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

Обратите внимание, что при инициализации объекта Cipher он теряет все ранее полученные состояния. Другими словами, инициализация Cipher эквивалентна созданию нового экземпляра этого Cipher и его инициализации.

Шифр инициализируется для одной из следующих четырёх операций: шифрования, дешифрования, обертывания ключа или распаковки ключа, в зависимости от значения opmode.

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

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

Если шифру (включая базовый механизм обратной связи или заполнения) требуются случайные байты (например, для генерации параметров), они будут взяты из random.

Обратите внимание, что при инициализации объекта Cipher он теряет все ранее полученные состояния. Другими словами, инициализация Cipher эквивалентна созданию нового экземпляра этого Cipher и его инициализации.

Шифр инициализируется для одной из четырёх операций: шифрования, дешифрования, обертывания ключа или распаковки ключа, в зависимости от значения opmode.

Если сертификат типа X.509 и содержит поле расширения key usage, помеченное как критическое, и значение этого поля расширения подразумевает, что открытый ключ в сертификате и соответствующий ему закрытый ключ не должны использоваться для операции, представленной значением opmode, выбрасывается InvalidKeyException.

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

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

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

Обратите внимание, что при инициализации объекта Cipher он теряет все ранее полученное состояние. Другими словами, инициализация Cipher эквивалентна созданию нового экземпляра этого Cipher и его инициализации.

Шифр инициализируется для одной из четырёх операций: шифрования, дешифрования, обертывания ключа или распаковки ключа, в зависимости от значения opmode.

Если сертификат типа X.509 и содержит поле расширения key usage, помеченное как критическое, и значение этого поля расширения подразумевает, что открытый ключ в сертификате и соответствующий ему закрытый ключ не должны использоваться для операции, представленной значением opmode, выбрасывается InvalidKeyException.

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

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

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

Обратите внимание, что при инициализации объекта Cipher он теряет все ранее полученное состояние. Другими словами, инициализация Cipher эквивалентна созданию нового экземпляра этого Cipher и его инициализации.

Байты в буфере input обрабатываются, а результат хранится в новом буфере.

Если длина input равна нулю, этот метод возвращает null.

Первые inputLen байты в буфере input, начиная с inputOffset включительно, обрабатываются, а результат хранится в новом буфере.

Если inputLen равно нулю, этот метод возвращает null.

Первые inputLen байтов в буфере input, начиная с inputOffset включительно, обрабатываются, а результат хранится в буфере output.

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

Если inputLen равно нулю, этот метод возвращает длину ноль.

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

Первые inputLen байтов в буфере input, начиная с inputOffset включительно, обрабатываются, а результат сохраняется в буфере output, начиная с outputOffset включительно.

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

Если inputLen равно нулю, этот метод возвращает длину нулю.

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

Все input.remaining() байты, начиная со input.position(), обрабатываются. Результат сохраняется в буфере вывода. По возвращении позиция буфера ввода будет равна его пределу; его предел не изменится. Позиция буфера вывода будет продвинута на n, где n - значение, возвращаемое этим методом; предел буфера вывода не изменится.

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

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

Входные данные, которые могли быть буферизованы во время предыдущей операции update, обрабатываются с применением заполнения (если запрошено). Если используется режим AEAD, такой как GCM/CCM, тег аутентификации добавляется в случае шифрования или проверяется в случае дешифрования. Результат сохраняется в новом буфере.

После завершения этот метод сбрасывает этот объект шифра до состояния, в котором он находился при предыдущей инициализации с помощью вызова init. То есть объект сбрасывается и готов к шифрованию или дешифрованию (в зависимости от режима операции, указанного в вызове init) дополнительных данных.

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

Входные данные, которые могли быть буферизованы во время предыдущей операции update, обрабатываются с применением заполнения (если запрошено). Если используется режим AEAD, такой как GCM/CCM, тег аутентификации добавляется в случае шифрования или проверяется в случае дешифрования. Результат сохраняется в буфере output, начиная со смещения outputOffset включительно.

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

После завершения этот метод сбрасывает этот объект шифра до состояния, в котором он находился при предыдущей инициализации с помощью вызова init. То есть объект сбрасывается и готов к шифрованию или дешифрованию (в зависимости от режима операции, указанного в вызове init) дополнительных данных.

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

Байты в буфере input и любые входные байты, которые могли быть буферизованы во время предыдущей операции update, обрабатываются с применением заполнения (если запрошено). Если используется режим AEAD, такой как GCM/CCM, тег аутентификации добавляется в случае шифрования или проверяется в случае дешифрования. Результат сохраняется в новом буфере.

После завершения этот метод сбрасывает этот объект шифра до состояния, в котором он находился при предыдущей инициализации с помощью вызова init. То есть объект сбрасывается и готов к шифрованию или дешифрованию (в зависимости от режима операции, указанного в вызове init) дополнительных данных.

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

Первые inputLen байты в буфере input, начиная с inputOffset включительно, и любые входные байты, которые могли быть буферизованы во время предыдущей операции update, обрабатываются с применением заполнения (если запрошено). Если используется режим AEAD, такой как GCM/CCM, тег аутентификации добавляется в случае шифрования или проверяется в случае дешифрования. Результат хранится в новом буфере.

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

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

Первые inputLen байты в буфере input, начиная с inputOffset включительно, и любые входные байты, которые могли быть буферизованы во время предыдущей операции update, обрабатываются с применением заполнения (если запрошено). Если используется режим AEAD, такой как GCM/CCM, тег аутентификации добавляется в случае шифрования или проверяется в случае дешифрования. Результат сохраняется в буфере output.

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

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

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

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

Первые inputLen байты в буфере input, начиная с inputOffset включительно, и любые входные байты, которые могли быть буферизованы во время предыдущей операции update, обрабатываются с применением заполнения (если запрошено). Если используется режим AEAD, такой как GCM/CCM, тег аутентификации добавляется в случае шифрования или проверяется в случае дешифрования. Результат сохраняется в буфере output, начиная со смещения outputOffset включительно.

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

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

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

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

Все input.remaining() байты, начиная со смещения input.position(), обрабатываются. Если используется режим AEAD, такой как GCM/CCM, тег аутентификации добавляется в случае шифрования или проверяется в случае дешифрования. Результат сохраняется в буфере вывода. По завершении, позиция входного буфера будет равна его пределу; его предел не изменится. Позиция буфера вывода будет смещена на n, где n - значение, возвращаемое этим методом; предел буфера вывода не изменится.

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

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

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

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

Вызовы этого метода предоставляют AAD шифру при работе в режимах, таких как AEAD (GCM/CCM). Если этот шифр работает в режиме GCM или CCM, все AAD должны быть предоставлены перед началом операций с шифрованным текстом (через методы update и doFinal).

Вызовы этого метода предоставляют AAD шифру при работе в режимах, таких как AEAD (GCM/CCM). Если этот шифр работает в режиме GCM или CCM, все AAD должны быть предоставлены перед началом операций с шифрованным текстом (через методы update и doFinal).

Вызовы этого метода предоставляют AAD шифру при работе в режимах, таких как AEAD (GCM/CCM). Если этот шифр работает в режиме GCM или CCM, все AAD должны быть предоставлены перед началом операций с шифрованным текстом (через методы update и doFinal).

Все байты src.remaining() с src.position() обрабатываются. По возвращении позиция входного буфера будет равна его пределу; его предел не изменится.