Перечисление StandardOpenOption

java.lang.Object
- java.lang.Enum<StandardOpenOption>
- - java.nio.file.StandardOpenOption

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

public enum StandardOpenOption
extends Enum<StandardOpenOption>
implements OpenOption

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

С:: 1.7

Перечисление констант

Константа перечисления и описание
`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, 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()

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

for (StandardOpenOption c : StandardOpenOption.values())
    System.out.println(c);

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

valueOf

public static StandardOpenOption valueOf(String name)

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

Параметры:: name - имя константы перечисления, которое нужно вернуть.
Возвращает:: константу перечисления с заданным именем
Исключения:: IllegalArgumentException - если в этом типе перечисления нет константы с заданным именем; NullPointerException - если аргумент равен null

© 1993, 2020, 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.