Класс FileDescriptor
java.lang.Object
java.io.FileDescriptor
public final class FileDescriptor extends Object
Экземпляры класса FileDescriptor служат неким непрозрачным указателем на внутреннюю, зависящую от платформы, структуру, представляющую открытый файл, открытый сокет или другой источник или приемник байтов. Основное практическое применение FileDescriptor — создание
FileInputStream или FileOutputStream для его использования. Приложения не должны создавать собственные FileDescriptor.
- С момента:
- 1.0
Краткое описание полей
| Модификатор и тип | Поле | Описание |
|---|---|---|
static final FileDescriptor |
err |
Указатель на стандартный поток ошибок. |
static final FileDescriptor |
in |
Указатель на стандартный поток ввода. |
static final FileDescriptor |
out |
Указатель на стандартный поток вывода. |
Краткое описание конструкторов
| Конструктор | Описание |
|---|---|
FileDescriptor() |
Конструирует объект FileDescriptor (недействителен). |
Краткое описание методов
Подробное описание полей
in
public static final FileDescriptor in
Указатель на стандартный поток ввода. Обычно этот FileDescriptor не используется напрямую, а через поток ввода, известный как
System.in.- См. также:
out
public static final FileDescriptor out
Указатель на стандартный поток вывода. Обычно этот FileDescriptor не используется напрямую, а через поток вывода, известный как
System.out.- См. также:
err
public static final FileDescriptor err
Указатель на стандартный поток ошибок. Обычно этот FileDescriptor не используется напрямую, а через поток вывода, известный как
System.err.- См. также:
Подробное описание конструкторов
FileDescriptor
public FileDescriptor()
Конструирует объект FileDescriptor (недействителен). Значение fd или handle устанавливается позже.
Подробное описание методов
valid
public boolean valid()
Проверка валидности объекта FileDescriptor.
- Возвращает:
-
true, если объект FileDescriptor представляет собой действительный, открытый файл, сокет или другое активное соединение ввода-вывода;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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/io/FileDescriptor.html
