java.io

Класс FileInputStream

java.lang. Объект

java.io. InputStream

java.io. FileInputStream

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

Closeable, AutoCloseable

public class FileInputStream
extends InputStream

A FileInputStream получает входные байты из файла в файловой системе. То, какие файлы доступны, зависит от среды узла.

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

С тех пор:

JDK1.0

См. Также:

File, FileDescriptor, FileOutputStream, Files.newInputStream(java.nio.file.Path, java.nio.file.OpenOption...)

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

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

Конструктор и Описание
FileInputStream(File file) Создает a FileInputStream открывая соединение с фактическим файлом, файл, названный File объект file в файловой системе.
FileInputStream(FileDescriptor fdObj) Создает a FileInputStream при использовании дескриптора файла fdObj, который представляет существующее соединение с фактическим файлом в файловой системе.
FileInputStream(String name) Создает a FileInputStream открывая соединение с фактическим файлом, файл называет путь name в файловой системе.

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

Методы

Модификатор и Тип	Метод и Описание
int	available() Возвращает оценку числа остающихся байтов, которые могут быть считаны (или перескочиться) от этого входного потока, не блокируя следующим вызовом метода для этого входного потока.
void	close() Завершения этот входной поток файла и выпуски любые системные ресурсы связались с потоком.
protected void	finalize() Гарантирует что close метод этого входного потока файла вызывают, когда нет больше ссылок на это.
FileChannel	getChannel() Возвращает уникальное FileChannel объект связался с этим входным потоком файла.
FileDescriptor	getFD() Возвраты FileDescriptor объект, который представляет соединение с фактическим файлом в файловой системе, используемой этим FileInputStream.
int	read() Читает байт данных от этого входного потока.
int	read(byte[] b) Чтения до b.length байты данных от этого входного потока в массив байтов.
int	read(byte[] b, int off, int len) Чтения до len байты данных от этого входного потока в массив байтов.
long	skip(long n) Перескакивает и отбрасывает n байты данных от входного потока.

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

mark, markSupported, reset

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

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

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

FileInputStream

public FileInputStream(String name)
                throws FileNotFoundException

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

Во-первых, если есть менеджер безопасности, checkRead метод вызывают с name параметр как его параметр.

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

Параметры:

name - системно-зависимое имя файла.

Броски:

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

SecurityException - если менеджер безопасности существует и checkRead метод отрицает доступ для чтения к файлу.

См. Также:

SecurityManager.checkRead(java.lang.String)

FileInputStream

public FileInputStream(File file)
                throws FileNotFoundException

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

Во-первых, если есть менеджер безопасности, checkRead метод вызывают с путем, представленным file параметр как его параметр.

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

Параметры:

file - файл, который будет открыт для того, чтобы читать.

Броски:

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

SecurityException - если менеджер безопасности существует и checkRead метод отрицает доступ для чтения к файлу.

См. Также:

File.getPath(), SecurityManager.checkRead(java.lang.String)

FileInputStream

public FileInputStream(FileDescriptor fdObj)

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

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

Если fdObj нуль тогда a NullPointerException бросается.

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

Параметры:

fdObj - дескриптор файла, который будет открыт для того, чтобы читать.

Броски:

SecurityException - если менеджер безопасности существует и checkRead метод отрицает доступ для чтения к дескриптору файла.

См. Также:

SecurityManager.checkRead(java.io.FileDescriptor)

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

читать

public int read()
         throws IOException

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

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

read в классе InputStream

Возвраты:

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

Броски:

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

читать

public int read(byte[] b)
         throws IOException

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

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

read в классе InputStream

Параметры:

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

Возвраты:

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

Броски:

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

См. Также:

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

читать

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

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

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

read в классе InputStream

Параметры:

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

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

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

Возвраты:

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

Броски:

NullPointerException - Если b null.

IndexOutOfBoundsException - Если off отрицательно, len отрицательно, или len больше чем b.length - off

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

См. Также:

InputStream.read()

пропустить

public long skip(long n)
          throws IOException

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

skip метод, для множества причин, может закончить тем, что перескочил через некоторое меньшее число байтов, возможно 0. Если n отрицательно, IOException бросается, даже при том, что skip метод InputStream суперкласс ничего не делает в этом случае. Фактическое число пропущенных байтов возвращается.

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

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

skip в классе InputStream

Параметры:

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

Возвраты:

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

Броски:

IOException - если n отрицателен, если поток не поддерживает, ищут, или если ошибка ввода-вывода происходит.

доступный

public int available()
              throws IOException

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

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

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

available в классе InputStream

Возвраты:

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

Броски:

IOException - если этот входной поток файла был закрыт, вызывая close или ошибка ввода-вывода происходит.

близко

public void close()
           throws IOException

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

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

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

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

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

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

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

close в классе InputStream

Броски:

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

getFD

public final FileDescriptor getFD()
                           throws IOException

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

Возвраты:

объект дескриптора файла связался с этим потоком.

Броски:

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

См. Также:

FileDescriptor

getChannel

public FileChannel getChannel()

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

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

Возвраты:

канал файла связался с этим входным потоком файла

С тех пор:

1.4

завершить

protected void finalize()
                 throws IOException

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

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

finalize в классе Object

Броски:

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

См. Также:

close()