- 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
-
-
Enum Constant Summary
Enum Constants Enum Constant 描述 APPEND
如果为WRITE
访问打开文件,则字节将写入文件末尾而不是开头。CREATE
如果它不存在,请创建一个新文件。CREATE_NEW
如果文件已存在,则创建新文件失败。DELETE_ON_CLOSE
关闭时删除。DSYNC
要求将文件内容的每次更新同步写入底层存储设备。READ
打开以进行读取访问。SPARSE
稀疏文件。SYNC
要求将文件内容或元数据的每个更新同步写入底层存储设备。TRUNCATE_EXISTING
如果该文件已存在且已打开以进行WRITE
访问,则其长度将截断为0。WRITE
打开以进行写访问。
-
-
-
Enum Constant Detail
-
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
-
CREATE
public static final StandardOpenOption CREATE
-
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
-
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
-
-