Класс CipherInputStream

public class CipherInputStream
extends FilterInputStream

CipherInputStream состоит из объекта InputStream и объекта Cipher, так что методы read() возвращают данные, считанные из основного объекта InputStream, но дополнительно обработанные объектом Cipher. Cipher должен быть полностью инициализирован перед использованием CipherInputStream.

Например, если Cipher инициализирован для дешифрования, CipherInputStream будет пытаться считать данные и расшифровать их перед возвращением расшифрованных данных.

Этот класс строго соблюдает семантику, особенно семантику ошибок, своих предков java.io.FilterInputStream и java.io.InputStream. Этот класс содержит ровно те методы, что и его предковые классы, и переопределяет их все. Кроме того, этот класс перехватывает все исключения, которые не выбрасываются его предковыми классами. В частности, метод skip пропускает, а метод available подсчитывает только данные, обработанные инкапсулированным Cipher. Этот класс может перехватывать BadPaddingException и другие исключения, возникающие при несоответствии целостности во время дешифрования. Эти исключения не перебрасываются, поэтому клиент может не получить информацию о том, что проверки целостности не пройдены. Из-за этого поведения этот класс может быть непригоден для использования с дешифрованием в режиме аутентификации (например, GCM). Приложения, которым требуется аутентифицированное шифрование, могут использовать API Cipher напрямую как альтернативу использованию этого класса.

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