Класс перечисления 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, 2021, 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/17/docs/api/java.base/java/nio/file/StandardOpenOption.html