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 попытается читать в данных и дешифровать их, прежде, чем возвратить дешифрованные данные.

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

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

С тех пор:

1.4

См. Также:

InputStream, FilterInputStream, Cipher, CipherOutputStream

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

Поля 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 байты ввода от байтов, которые могут быть считаны из этого входного потока без блокирования.

Методы java.io унаследованный от класса. FilterInputStream

mark, reset

Методы 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 в классе FilterInputStream

Возвраты:

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

Броски:

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

С тех пор:

JCE1.2

См. Также:

FilterInputStream.in

читать

public int read(byte[] b)
         throws IOException

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

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

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

read в классе 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 в классе FilterInputStream

Параметры:

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

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

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

Возвраты:

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

Броски:

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

С тех пор:

JCE1.2

См. Также:

InputStream.read()

пропустить

public long skip(long n)
          throws IOException

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

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

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

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

skip в классе FilterInputStream

Параметры:

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

Возвраты:

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

Броски:

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

С тех пор:

JCE1.2

доступный

public int available()
              throws IOException

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

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

available в классе FilterInputStream

Возвраты:

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

Броски:

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

С тех пор:

JCE1.2

близко

public void close()
           throws IOException

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

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

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

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()