Класс FileInputStream

public FileInputStream(String name) throws FileNotFoundException

Создаёт FileInputStream путём открытия соединения с фактическим файлом, файлом с именем, заданным именем пути name в файловой системе. Новый объект FileDescriptor создаётся для представления этого соединения с файлом.

Сначала, если существует менеджер безопасности, вызывается его метод checkRead с аргументом name.

Если указанный файл не существует, является каталогом, а не обычным файлом, или по какой-либо другой причине не может быть открыт для чтения, то будет выброшено исключение FileNotFoundException.

public FileInputStream(File file) throws FileNotFoundException

Создаёт FileInputStream путём открытия соединения с фактическим файлом, файлом, указанным объектом File file в файловой системе. Новый объект FileDescriptor создаётся для представления этого соединения с файлом.

Сначала, если существует менеджер безопасности, вызывается его метод checkRead с путём, представленным аргументом file.

Если указанный файл не существует, является каталогом, а не обычным файлом, или по какой-либо другой причине не может быть открыт для чтения, то будет выброшено исключение FileNotFoundException.

public FileInputStream(FileDescriptor fdObj)

Создаёт FileInputStream с использованием дескриптора файла fdObj, который представляет собой существующее соединение с фактическим файлом в файловой системе.

Если существует менеджер безопасности, вызывается его метод checkRead с дескриптором файла fdObj в качестве аргумента, чтобы проверить, разрешено ли чтение дескриптора файла. Если доступ для чтения к дескриптору файла запрещён, то выброшено исключение SecurityException.

Если fdObj равно null, то выброшено исключение NullPointerException.

Этот конструктор не выбрасывает исключение, если fdObj invalid. Однако, если методы вызываются на полученном потоке для попытки ввода-вывода по потоку, то выброшено исключение IOException.

public int read() throws IOException

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

public int read(byte[] b) throws IOException

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

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

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

public long skip(long n) throws IOException

Пропускает и отбрасывает n байт данных из потока ввода.

Метод skip может, по разным причинам, пропустить меньшее количество байтов, возможно, 0. Если n отрицательно, метод попытается пропустить назад. В случае, если обратная перемотка по текущей позиции не поддерживается файлом, выброшено исключение IOException. Возвращается фактическое количество пропущенных байтов. Если пропуск вперёд, возвращается положительное значение. Если пропуск назад, возвращается отрицательное значение.

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

public int available() throws IOException

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

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

public void close() throws IOException

Закрывает этот поток ввода-вывода файла и освобождает все системные ресурсы, связанные с потоком.

Если у этого потока есть связанный канал, то он также закрывается.

public final FileDescriptor getFD() throws IOException

Возвращает объект FileDescriptor, представляющий подключение к фактическому файлу в файловой системе, используемому этим FileInputStream.

public FileChannel getChannel()

Возвращает уникальный объект FileChannel, связанный с этим потоком для ввода из файла.

Начальное значение position возвращаемого канала будет равно количеству байтов, прочитанных из файла до сих пор. Чтение байтов из этого потока увеличивает позицию канала. Изменение позиции канала, как явно, так и посредством чтения, изменит позицию файла в этом потоке.