Класс 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.

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

CipherInputStream

public CipherInputStream(InputStream is,
                         Cipher c)

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

Параметры:

is - обрабатываемый входной поток

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

CipherInputStream

protected CipherInputStream(InputStream is)

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

Параметры:

is - обрабатываемый входной поток

Методы

read

public int read()
         throws IOException

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

read в классе FilterInputStream

Возвращает:

следующий байт данных или -1, если достигнут конец потока.

Исключения:

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

С момента:

JCE1.2

См. также:

FilterInputStream.in

read

public int read(byte[] b)
         throws IOException

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

read в классе FilterInputStream

Параметры:

b - буфер, в который считываются данные.

Возвращает:

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

Исключения:

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

С момента:

JCE1.2

См. также:

InputStream.read(byte[], int, int)

read

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

Считывает до len байтов данных из этого входного потока в массив байтов. Этот метод блокируется до тех пор, пока доступны данные. Если первый аргумент равен null,, до len байтов считываются и отбрасываются.

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

read в классе FilterInputStream

Параметры:

b - буфер, в который считываются данные.

off - начальный смещение в целевом массиве buf

len - максимальное количество считываемых байтов.

Возвращает:

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

Исключения:

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

С момента:

JCE1.2

См. также:

InputStream.read()

skip

public long skip(long n)
          throws IOException

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

skip в классе FilterInputStream

Параметры:

n - количество байтов, которые нужно пропустить.

Возвращает:

фактическое количество пропущенных байтов.

Исключения:

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

С момента:

JCE1.2

available

public int available()
              throws IOException

Возвращает количество байтов, которые можно прочитать из этого входного потока без блокировки. Метод available класса InputStream возвращает 0. Этот метод должен быть переопределён подклассами.

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

available в классе FilterInputStream

Возвращает:

количество байтов, которые можно прочитать из этого входного потока без блокировки.

Исключения:

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

С момента:

JCE1.2

close

public void close()
           throws IOException

Определено в:

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

Определено в:

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

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

close в классе FilterInputStream

Исключения:

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

С момента:

JCE1.2

См. также:

FilterInputStream.in

markSupported

public boolean markSupported()

Проверяет, поддерживает ли этот входной поток методы mark и reset, чего он не делает.

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

markSupported в классе FilterInputStream

Возвращает:

false, так как этот класс не поддерживает методы mark и reset.

С момента:

JCE1.2

См. также:

InputStream.mark(int), InputStream.reset()