Класс 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. Следующий вызов может быть от того же потока или другого потока. Один единственный вызов read или skip с таким количеством байтов не заблокирует поток, но может прочитать или пропустить меньше байтов.

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

public void close() throws IOException

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

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

public final FileDescriptor getFD() throws IOException

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

public FileChannel getChannel()

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

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