Класс-перечисление StandardOpenOption
- Все реализуемые интерфейсы:
Serializable, Comparable<StandardOpenOption>, Constable, OpenOption
public enum StandardOpenOption extends Enum<StandardOpenOption> implements OpenOption
Определяет стандартные параметры открытия.
- Начиная с версии:
- 1.7
Краткое описание вложенных классов
Вложенные классы и интерфейсы, объявленные в классе Enum
Enum.EnumDesc<E>
Краткое описание констант перечисления
| Константа перечисления | Описание |
|---|---|
APPEND |
Если файл открыт для доступа на WRITE, байты будут записываться в конец файла, а не в его начало. |
CREATE |
Создать новый файл, если он не существует. |
CREATE_NEW |
Создать новый файл; завершить операцию ошибкой, если файл уже существует. |
DELETE_ON_CLOSE |
Удалить при закрытии. |
DSYNC |
Требует, чтобы каждое обновление содержимого файла синхронно записывалось на базовое устройство хранения данных. |
READ |
Открыть для чтения. |
SPARSE |
Разреженный файл. |
SYNC |
Требует, чтобы каждое обновление содержимого файла или его метаданных синхронно записывалось на базовое устройство хранения данных. |
TRUNCATE_EXISTING |
Если файл уже существует и открыт для доступа на WRITE, его длина усекается до 0. |
WRITE |
Открыть для записи. |
Краткое описание методов
| Модификатор и тип | Метод | Описание |
|---|---|---|
static StandardOpenOption |
valueOf |
Возвращает константу перечисления этого класса с указанным именем. |
static StandardOpenOption[] |
values() |
Возвращает массив, содержащий константы этого класса-перечисления в порядке их объявления. |
Подробное описание констант перечисления
READ
public static final StandardOpenOption READ
Открыть для чтения.
WRITE
public static final StandardOpenOption WRITE
Открыть для записи.
APPEND
public static final StandardOpenOption APPEND
Если файл открыт для доступа на
WRITE, байты будут записываться в конец файла, а не в его начало. Если файл открыт для записи другими программами, атомарность записи в конец файла зависит от файловой системы.
TRUNCATE_EXISTING
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.
https://docs.oracle.com/en/java/javase/25/docs/api/java.base/java/nio/file/StandardOpenOption.html
