Класс FileDescriptor

public final class FileDescriptor
extends Object

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

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

Поля

in

public static final FileDescriptor in

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

См. также:

System.in

out

public static final FileDescriptor out

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

См. также:

System.out

err

public static final FileDescriptor err

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

См. также:

System.err

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

FileDescriptor

public FileDescriptor()

Создаёт объект FileDescriptor (недействительный).

Методы

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 — выброшено, когда буферы не могут быть сброшены или система не может гарантировать, что все буферы были синхронизированы с физическим носителем.

Since:

JDK1.1