Класс CipherOutputStream

public class CipherOutputStream
extends FilterOutputStream

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

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

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

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

Конструкторы

CipherOutputStream

public CipherOutputStream(OutputStream os,
                          Cipher c)

Создаёт CipherOutputStream из OutputStream и Cipher.
Примечание: если указанный поток вывода или шифр равен null, может быть брошено NullPointerException позже, когда они будут использованы.

Параметры:

os - объект OutputStream

c - инициализированный объект Cipher

CipherOutputStream

protected CipherOutputStream(OutputStream os)

Создаёт CipherOutputStream из OutputStream без указания Cipher. Это эквивалентно созданию CipherOutputStream с использованием NullCipher.
Примечание: если указанный поток вывода равен null, может быть брошено NullPointerException позже, когда он будет использован.

Параметры:

os - объект OutputStream

Методы

write

public void write(int b)
           throws IOException

Записывает указанный байт в этот поток вывода.

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

write в классе FilterOutputStream

Параметры:

b - байт.

Исключение:

IOException - если произошла ошибка ввода-вывода.

С тех пор:

JCE1.2

write

public void write(byte[] b)
           throws IOException

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

write в классе FilterOutputStream

Параметры:

b - данные.

Исключение:

NullPointerException - если b равно null.

IOException - если произошла ошибка ввода-вывода.

С тех пор:

JCE1.2

См. также:

write(byte[], int, int)

write

public void write(byte[] b,
                  int off,
                  int len)
           throws IOException

Записывает len байт из указанного массива байт, начиная со смещения off, в этот поток вывода.

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

write в классе FilterOutputStream

Параметры:

b - данные.

off - начальное смещение в данных.

len - количество байт для записи.

Исключение:

IOException - если произошла ошибка ввода-вывода.

С тех пор:

JCE1.2

См. также:

FilterOutputStream.write(int)

flush

public void flush()
           throws IOException

Указано в:

flush в интерфейсе Flushable

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

flush в классе FilterOutputStream

Исключение:

IOException - если произошла ошибка ввода-вывода.

С тех пор:

JCE1.2

См. также:

FilterOutputStream.out

close

public void close()
           throws IOException

Указано в:

close в интерфейсе Closeable

Указано в:

close в интерфейсе AutoCloseable

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

close в классе FilterOutputStream

Исключение:

IOException - если произошла ошибка ввода-вывода.

С тех пор:

JCE1.2

См. также:

FilterOutputStream.flush(), FilterOutputStream.out