Класс 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 (недействительный). |
Краткое описание методов
Подробное описание полей
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 или handle задаётся позднее.
Подробное описание методов
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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/io/FileDescriptor.html
