Enum StandardOpenOption

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

All Implemented Interfaces:: Serializable, Comparable<StandardOpenOption>, OpenOption

public enum StandardOpenOption
extends Enum<StandardOpenOption>
implements OpenOption

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

Since:: 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, так и по возможности аварийно). Этот параметр предназначен в первую очередь для использования с временными файлами, которые используются только одной экземплярой виртуальной машины 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