模块 java.base

包 java.nio.file

枚举类枚举类 StandardOpenOption

java.lang.Object

java.lang.Enum <StandardOpenOption >

java.nio.file.StandardOpenOption

所有已实现的接口：

Serializable , Comparable<StandardOpenOption> , Constable , OpenOption

public enum StandardOpenOption extends Enum <StandardOpenOption > implements OpenOption 
      

定义标准打开选项。

自从：

1.7

内部类总结

在类 java.lang.Enum 中声明的嵌套类/接口

Enum.EnumDesc<E extends Enum<E>>

枚举常量总结

枚举常量

枚举常量	描述
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, describeConstable, 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 方法关闭时尝试 best effort 删除文件。如果未调用 close 方法，则 best effort 尝试在 Java 虚拟机终止时删除该文件（正常情况下，如 Java 语言规范所定义，或者在可能的情况下异常终止）。此选项主要用于 work files，它们仅由 Java 虚拟机的单个实例使用。打开由其他实体同时打开的文件时，不建议使用此选项。许多关于何时以及如何删除文件的细节是特定于实现的，因此没有指定。特别是，当文件打开时被攻击者替换时，实现可能无法保证它会删除预期的文件。因此，安全敏感的应用程序在使用此选项时应小心。

出于安全原因，此选项可能暗示 LinkOption.NOFOLLOW_LINKS 选项。换句话说，如果在打开作为符号链接的现有文件时存在该选项，则它可能会失败（通过抛出 IOException ）。

SPARSE

public static final StandardOpenOption  SPARSE
            

稀疏文件。当与 CREATE_NEW 选项一起使用时，此选项提供了一个 hint 新文件将是稀疏的。当文件系统不支持创建稀疏文件时，该选项将被忽略。

SYNC

public static final StandardOpenOption  SYNC
            

要求对文件内容或元数据的每次更新都同步写入底层存储设备。

参见：

• 同步 I/O 文件完整性

DSYNC

public static final StandardOpenOption  DSYNC
            

要求对文件内容的每次更新都同步写入底层存储设备。

参见：

• 同步 I/O 文件完整性

方法详情

values

public static StandardOpenOption [] values()
            

返回一个数组，其中包含此枚举类的常量，按照它们声明的顺序排列。

返回：

包含此枚举类常量的数组，按照它们声明的顺序排列

valueOf

public static StandardOpenOption  valueOf(String  name)
            

返回具有指定名称的此类的枚举常量。字符串必须匹配确切地用于在此类中声明枚举常量的标识符。 （不允许使用无关的空白字符。）

参数：

name - 要返回的枚举常量的名称。

返回：

具有指定名称的枚举常量

抛出：

IllegalArgumentException - 如果此枚举类没有具有指定名称的常量

NullPointerException - 如果参数为空