Класс перечисления 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

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

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

Enum.EnumDesc<E extends Enum<E>>

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

Постоянная перечисления	Описание
`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()`	Возвращает массив, содержащий константы этого класса перечисления в порядке их объявления.

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

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

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

getClass, notify, notifyAll, wait, wait, wait

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

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. Этот параметр не рекомендуется использовать при открытии файлов, которые открыты одновременно другими сущностями. Многие детали о том, когда и как файл удаляется, зависят от реализации и поэтому не указаны. В частности, реализация может не гарантировать удаление ожидаемого файла при замене злоумышленником во время открытия файла. Поэтому приложениям, чувствительным к безопасности, следует быть осторожными при использовании этого параметра.

По соображениям безопасности этот параметр может подразумевать параметр 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.
https://download.java.net/java/early_access/jdk24/docs/api/java.base/java/nio/file/StandardOpenOption.html