Класс FileDescriptor

java.lang.Object

java.io.FileDescriptor

public final class FileDescriptor extends Object

Экземпляры класса дескрипторов файлов служат непрозрачным дескриптором базовой машинно-зависимой структуры, представляющей открытый файл, открытый сокет или другой источник или приемник байтов. Основное практическое применение дескриптора файла — создание FileInputStream или FileOutputStream для его хранения.

Приложениям не следует создавать собственные дескрипторы файлов.

Начиная с:: 1.0

Краткое описание полей

Модификатор и тип	Поле	Описание
`static final FileDescriptor`	`err`	Дескриптор стандартного потока ошибок.
`static final FileDescriptor`	`in`	Дескриптор стандартного потока ввода.
`static final FileDescriptor`	`out`	Дескриптор стандартного потока вывода.

Краткое описание конструкторов

Конструктор	Описание
`FileDescriptor()`	Создает объект FileDescriptor (недействительный).

Краткое описание методов

Модификатор и тип	Метод	Описание
`void`	`sync()`	Принудительно синхронизирует все системные буферы с базовым устройством.
`boolean`	`valid()`	Проверяет, является ли этот объект дескриптора файла действительным.

Методы, объявленные в классе Object

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

Модификатор и тип	Метод	Описание
`protected Object`	`clone()`	Создает и возвращает копию этого объекта.
`boolean`	`equals(Object obj)`	Указывает, является ли другой объект «равным» этому объекту.
`protected void`	`finalize()`	Устарело, будет удалено: этот элемент API подлежит удалению в будущей версии. Финализация устарела и подлежит удалению в одном из следующих выпусков.
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`int`	`hashCode()`	Возвращает хеш-код этого объекта.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`String`	`toString()`	Возвращает строковое представление объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо истечения заданного промежутка реального времени.

Подробное описание полей

in

public static final FileDescriptor in

Дескриптор стандартного потока ввода. Обычно этот дескриптор файла не используется напрямую, а применяется через поток ввода, известный как System.in.

См. также:

out

public static final FileDescriptor out

Дескриптор стандартного потока вывода. Обычно этот дескриптор файла не используется напрямую, а применяется через поток вывода, известный как System.out.

См. также:

err

public static final FileDescriptor err

Дескриптор стандартного потока ошибок. Обычно этот дескриптор файла не используется напрямую, а применяется через поток вывода, известный как System.err.

См. также:

Подробное описание конструкторов

FileDescriptor

public FileDescriptor()

Создает объект FileDescriptor (недействительный). Значение fd или дескриптор задается позже.

Подробное описание методов

valid

public boolean valid()

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

Возвращает:: true, если объект дескриптора файла представляет действительный открытый файл, сокет или другое активное соединение ввода-вывода; в противном случае — false.

sync

public void sync() throws SyncFailedException

Принудительно синхронизирует все системные буферы с базовым устройством. Этот метод возвращает управление после записи всех измененных данных и атрибутов этого FileDescriptor на соответствующие устройства. В частности, если этот FileDescriptor ссылается на физический носитель данных, например файл в файловой системе, метод sync не вернет управление, пока все измененные копии буферов, связанные с этим FileDescriptor и находящиеся в памяти, не будут записаны на физический носитель. Метод sync предназначен для кода, которому необходимо, чтобы физическое хранилище (например, файл) находилось в известном состоянии. Например, класс, предоставляющий простые средства для транзакций, может использовать sync, чтобы гарантировать запись на носитель данных всех изменений файла, вызванных данной транзакцией. Метод sync влияет только на буферы, расположенные ниже этого FileDescriptor. Если приложение использует буферизацию в памяти (например, объект BufferedOutputStream), эти буферы необходимо сбросить в FileDescriptor (например, вызвав OutputStream.flush), прежде чем на эти данные подействует sync.

Выбрасывает:: SyncFailedException — возникает, если буферы невозможно сбросить или система не может гарантировать синхронизацию всех буферов с физическим носителем.
Начиная с:: 1.1

© 1993, 2025, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.