javax.crypto

Класс CipherInputStream

java.lang. Объект

java.io. InputStream

java.io. FilterInputStream

javax.crypto. CipherInputStream

Все Реализованные Интерфейсы:

Closeable, AutoCloseable

public class CipherInputStream
extends FilterInputStream

CipherInputStream составляется из InputStream и Шифра так, чтобы считанный () методы возвратили данные, которые читаются в из базового InputStream, но были дополнительно обработаны Шифром. Шифр должен быть полностью инициализирован прежде, чем быть используемым CipherInputStream.

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

Этот class придерживается строго семантики, особенно семантика отказа, ее классов предка java.io. FilterInputStream и java.io. InputStream. Этот class имеет точно те методы, определенные в его классах предка, и переопределяет их всех. Кроме того этот class ловит все исключения, которые не выдаются его классами предка. В частности skip пропуски метода, и available метод считает только данные, которые были обработаны инкапсулировавшим Шифром.

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

С тех пор:

1.4

См. Также:

InputStream, FilterInputStream, Cipher, CipherOutputStream

Полевая Сводка

Поля, наследованные от class java.io. FilterInputStream

в

Сводка конструктора

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

Модификатор	Конструктор и Описание
protected	CipherInputStream(InputStream is) Создает CipherInputStream из InputStream, не определяя Шифр.
	CipherInputStream(InputStream is, Cipher c) Создает CipherInputStream из InputStream и Шифра.

Сводка метода

Модификатор и Тип	Метод и Описание
int	available() Возвращает число байтов, которые могут быть считаны из этого входного потока без блокирования.
void	close() Завершения этот входной поток и выпуски любые системные ресурсы связались с потоком.
boolean	markSupported() Тесты, если этот входной поток поддерживает mark и reset методы, которые это не делает.
int	read() Читает следующий байт данных от этого входного потока.
int	read(byte[] b) Чтения до b.length байты данных от этого входного потока в массив байтов.
int	read(byte[] b, int off, int len) Чтения до len байты данных от этого входного потока в массив байтов.
long	skip(long n) Пропуски n байты ввода от байтов, которые могут быть считаны из этого входного потока без блокирования.

Методы, наследованные от class java.io. FilterInputStream

mark, reset

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

CipherInputStream

public CipherInputStream(InputStream is,
                         Cipher c)

Создает CipherInputStream из InputStream и Шифра.
Отметьте: если указанный входной поток или шифр являются нулем, NullPointerException может быть брошен позже, когда они используются.

Параметры:

is - будущим образом обработанный входной поток

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

CipherInputStream

protected CipherInputStream(InputStream is)

Создает CipherInputStream из InputStream, не определяя Шифр. Это имеет эффект построения CipherInputStream, используя NullCipher.
Отметьте: если указанный входной поток является нулем, NullPointerException может быть брошен позже, когда это используется.

Параметры:

is - будущим образом обработанный входной поток

Деталь метода

читать

public int read()
         throws IOException

Читает следующий байт данных от этого входного потока. Байт значения возвращается как int в диапазоне 0 к 255. Если никакой байт не доступен, потому что конец потока был достигнут, значение -1 возвращается. Этот метод блоки до входных данных доступен, конец потока обнаруживается, или исключение выдается.

Переопределения:

read в class FilterInputStream

Возвраты:

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

Броски:

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

С тех пор:

JCE1.2

См. Также:

FilterInputStream.in

читать

public int read(byte[] b)
         throws IOException

Чтения до b.length байты данных от этого входного потока в массив байтов.

read метод InputStream вызовы read метод трех параметров с параметрами b, 0, и b.length.

Переопределения:

read в class FilterInputStream

Параметры:

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

Возвраты:

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

Броски:

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

С тех пор:

JCE1.2

См. Также:

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

читать

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

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

Переопределения:

read в class FilterInputStream

Параметры:

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

off - запуск смещается в целевом массиве buf

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

Возвраты:

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

Броски:

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

С тех пор:

JCE1.2

См. Также:

InputStream.read()

пропустить

public long skip(long n)
          throws IOException

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

Могло бы быть пропущено меньше байтов чем требуемый. Фактическое число пропущенных байтов равно n или результат звонка available, какой бы ни меньше. Если n меньше чем нуль, никакие байты не пропускаются.

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

Переопределения:

skip в class FilterInputStream

Параметры:

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

Возвраты:

фактическое число байтов пропускается.

Броски:

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

С тех пор:

JCE1.2

доступный

public int available()
              throws IOException

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

Переопределения:

available в class FilterInputStream

Возвраты:

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

Броски:

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

С тех пор:

JCE1.2

близко

public void close()
           throws IOException

Завершения этот входной поток и выпуски любые системные ресурсы связались с потоком.

close метод CipherInputStream вызовы close метод его базового входного потока.

Определенный:

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

Определенный:

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

Переопределения:

close в class FilterInputStream

Броски:

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

С тех пор:

JCE1.2

См. Также:

FilterInputStream.in

markSupported

public boolean markSupported()

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

Переопределения:

markSupported в class FilterInputStream

Возвраты:

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

С тех пор:

JCE1.2

См. Также:

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