Класс перечисления StandardOpenOption

java.lang.Object

java.lang.Enum<StandardOpenOption>

java.nio.file.StandardOpenOption

Все реализуемые интерфейсы:: Serializable, Comparable<StandardOpenOption>, Constable, OpenOption

public enum StandardOpenOption extends Enum<StandardOpenOption> implements OpenOption

Определяет стандартные параметры открытия.

Начиная с версии:: 1.7

Краткое описание вложенных классов

Вложенные классы/интерфейсы, объявленные в классе Enum

Enum.EnumDesc<E>

Модификатор и тип	Класс	Описание
`static final class`	`Enum.EnumDesc<E extends Enum<E>>`	Номинальный дескриптор для константы `enum`.

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

Константа перечисления	Описание
`APPEND`	Если файл открыт для доступа на `WRITE`, байты будут записываться в конец файла, а не в его начало.
`CREATE`	Создать новый файл, если он не существует.
`CREATE_NEW`	Создать новый файл; завершить операцию с ошибкой, если файл уже существует.
`DELETE_ON_CLOSE`	Удалить при закрытии.
`DSYNC`	Требует синхронной записи каждого изменения содержимого файла на базовое устройство хранения.
`READ`	Открыть для чтения.
`SPARSE`	Разреженный файл.
`SYNC`	Требует синхронной записи каждого изменения содержимого или метаданных файла на базовое устройство хранения.
`TRUNCATE_EXISTING`	Если файл уже существует и он открыт для доступа на `WRITE`, его длина усекается до 0.
`WRITE`	Открыть для записи.

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

Модификатор и тип	Метод	Описание
`static StandardOpenOption`	`valueOf(String name)`	Возвращает константу перечисления этого класса с указанным именем.
`static StandardOpenOption[]`	`values()`	Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

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

clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Модификатор и тип	Метод	Описание
`protected final Object`	`clone()`	Выбрасывает CloneNotSupportedException.
`final int`	`compareTo(StandardOpenOption o)`	Сравнивает это перечисление с указанным объектом, определяя порядок.
`final Optional<Enum.EnumDesc<StandardOpenOption>>`	`describeConstable()`	Возвращает дескриптор перечисления `EnumDesc` для этого экземпляра, если его можно создать, или пустой `Optional`, если создать его нельзя.
`final boolean`	`equals(Object other)`	Возвращает true, если указанный объект равен этой константе перечисления.
`protected final void`	`finalize()`	Устарело, планируется удаление: этот элемент API может быть удален в будущей версии. Механизм финализации признан устаревшим и планируется к удалению.
`final Class<StandardOpenOption>`	`getDeclaringClass()`	Возвращает объект Class, соответствующий типу перечисления этой константы.
`final int`	`hashCode()`	Возвращает хеш-код этой константы перечисления.
`final String`	`name()`	Возвращает имя этой константы перечисления в точности так, как оно указано в объявлении перечисления.
`final int`	`ordinal()`	Возвращает порядковый номер этой константы перечисления (ее позицию в объявлении перечисления, где первой константе присваивается номер 0).
`String`	`toString()`	Возвращает имя этой константы перечисления, указанное в объявлении.
`static <T extends Enum<T>> T`	`valueOf(Class<T> enumClass, String name)`	Возвращает константу указанного класса перечисления с указанным именем.

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

getClass, notify, notifyAll, wait, wait, wait

Модификатор и тип	Метод	Описание
`final Class<?>`	`getClass()`	Возвращает класс времени выполнения этого `Object`.
`final void`	`notify()`	Пробуждает один поток, ожидающий на мониторе этого объекта.
`final void`	`notifyAll()`	Пробуждает все потоки, ожидающие на мониторе этого объекта.
`final void`	`wait()`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания.
`final void`	`wait(long timeoutMillis)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения определенного времени.
`final void`	`wait(long timeoutMillis, int nanos)`	Заставляет текущий поток ожидать пробуждения, обычно посредством уведомления или прерывания, либо до истечения определенного времени.

Подробное описание констант перечисления

READ

public static final StandardOpenOption READ

Открыть для чтения.

WRITE

public static final StandardOpenOption WRITE

Открыть для записи.

APPEND

public static final StandardOpenOption APPEND

Если файл открыт для доступа на WRITE, байты будут записываться в конец файла, а не в его начало.

Если другие программы открывают файл для записи, атомарность записи в конец файла зависит от файловой системы.

TRUNCATE_EXISTING

public static final StandardOpenOption TRUNCATE_EXISTING

Если файл уже существует и он открыт для доступа на WRITE, его длина усекается до 0. Этот параметр игнорируется, если файл открыт только для доступа на READ.

CREATE

public static final StandardOpenOption CREATE

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

CREATE_NEW

public static final StandardOpenOption CREATE_NEW

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

DELETE_ON_CLOSE

public static final StandardOpenOption DELETE_ON_CLOSE

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

По соображениям безопасности этот параметр может подразумевать параметр LinkOption.NOFOLLOW_LINKS. Иными словами, если этот параметр задан при открытии существующего файла, являющегося символической ссылкой, операция может завершиться ошибкой (выбросив IOException).

SPARSE

public static final StandardOpenOption SPARSE

Разреженный файл. Если этот параметр используется вместе с параметром CREATE_NEW, он служит подсказкой, что новый файл будет разреженным. Параметр игнорируется, если файловая система не поддерживает создание разреженных файлов.

SYNC

public static final StandardOpenOption SYNC

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

См. также:

DSYNC

public static final StandardOpenOption DSYNC

Требует синхронной записи каждого изменения содержимого файла на базовое устройство хранения.

См. также:

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

values

public static StandardOpenOption[] values()

Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

Возвращает:: массив, содержащий константы этого класса перечисления в порядке их объявления

valueOf

public static StandardOpenOption valueOf(String name)

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

Параметры:: name — имя возвращаемой константы перечисления.
Возвращает:: константу перечисления с указанным именем
Выбрасывает:: IllegalArgumentException — если в этом классе перечисления нет константы с указанным именем; NullPointerException — если аргумент равен null

© 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.