- 所有已实现的接口:
-
Serializable
,Comparable<StandardOpenOption>
,Constable
,OpenOption
定义了标准的打开选项。
- 自从:
- 1.7
-
Nested Class Summary
Nested classes/interfaces declared in class java.lang.Enum
Enum.EnumDesc<E extends Enum<E>>
-
Enum Constant Summary
Enum ConstantDescription如果文件以写入访问方式打开,则字节将被写入文件的末尾而不是开头。如果文件不存在,则创建一个新文件。创建一个新文件,如果文件已经存在则失败。关闭时删除。要求对文件内容的每次更新都同步写入到底层存储设备。以读取访问方式打开。稀疏文件。要求对文件内容或元数据的每次更新都同步写入到底层存储设备。如果文件已经存在并以写入访问方式打开,则其长度将被截断为0。以写入访问方式打开。 -
Method Summary
Modifier and TypeMethodDescriptionstatic StandardOpenOption
返回具有指定名称的此类的枚举常量。static StandardOpenOption[]
values()
返回包含此枚举类的常量的数组,按照它们声明的顺序排列。
-
Enum Constant Details
-
READ
以读取访问方式打开。 -
WRITE
以写入访问方式打开。 -
APPEND
如果文件以写入访问方式打开,则字节将被写入文件的末尾而不是开头。如果文件被其他程序以写入访问方式打开,则写入文件末尾是否原子操作取决于文件系统。
-
TRUNCATE_EXISTING
如果文件已经存在并以写入访问方式打开,则其长度将被截断为0。如果文件仅以读取访问方式打开,则此选项将被忽略。 -
CREATE
如果文件不存在,则创建一个新文件。如果同时设置了CREATE_NEW
选项,则此选项将被忽略。对文件的存在性检查和文件的创建(如果文件不存在)是相对于其他文件系统操作而言原子的。 -
CREATE_NEW
如果文件已经存在,则创建一个新文件将失败。对文件的存在性检查和文件的创建(如果文件不存在)是相对于其他文件系统操作而言原子的。 -
DELETE_ON_CLOSE
关闭时删除。当存在此选项时,实现会尽最大努力在适当的close
方法关闭文件时删除文件。如果未调用close
方法,则在Java虚拟机终止时(通常情况下,根据Java语言规范定义,或在可能的情况下,异常情况下)会尽最大努力删除文件。此选项主要用于仅由Java虚拟机的单个实例使用的工作文件。不建议在其他实体同时打开的文件时使用此选项。关于文件何时以及如何被删除的许多细节是特定于实现的,因此未指定。特别地,实现可能无法保证在文件被攻击者替换时,它删除了预期的文件。因此,安全敏感的应用程序在使用此选项时应小心。出于安全原因,此选项可能暗示
LinkOption.NOFOLLOW_LINKS
选项。换句话说,如果在打开一个现有文件时存在此选项,并且该文件是一个符号链接,则可能会失败(通过抛出IOException
)。 -
SPARSE
稀疏文件。当与CREATE_NEW
选项一起使用时,此选项提供了新文件将是稀疏的提示。当文件系统不支持创建稀疏文件时,此选项将被忽略。 -
SYNC
要求对文件的每次更新都同步写入到底层存储设备的内容或元数据。- 参见:
-
DSYNC
要求对文件的每次更新都同步写入到底层存储设备的内容。- 参见:
-
-
Method Details
-
values
返回包含此枚举类的常量的数组,按照它们声明的顺序排列。- 返回:
- 包含此枚举类的常量的数组,按照它们声明的顺序排列
-
valueOf
返回具有指定名称的此类的枚举常量。字符串必须与此类中用于声明枚举常量的标识符完全匹配。(不允许存在多余的空格字符。)- 参数:
-
name
- 要返回的枚举常量的名称。 - 返回:
- 具有指定名称的枚举常量
- 抛出:
-
IllegalArgumentException
- 如果此枚举类没有具有指定名称的常量 -
NullPointerException
- 如果参数为null
-