Класс CipherOutputStream

public class CipherOutputStream extends FilterOutputStream

CipherOutputStream состоит из OutputStream и объекта Cipher, поэтому методы write() сначала обрабатывают данные, а затем записывают их в нижележащий OutputStream. Объект Cipher должен быть полностью инициализирован до его использования CipherOutputStream.

Например, если объект Cipher инициализирован для шифрования, CipherOutputStream попытается зашифровать данные перед записью зашифрованных данных.

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

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