Класс перечисления 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, либо, где возможно, аварийном). Эта опция предназначена главным образом для использования с временными файлами, которые используются только одним экземпляром виртуальной машины 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, 2023, 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/21/docs/api/java.base/java/nio/file/StandardOpenOption.html