- 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
定义标准的开放选项。- 从以下版本开始:
- 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
打开以进行写入。
-
方法摘要
所有方法 静态方法 具体的方法 Modifier and Type 方法 描述 static StandardOpenOption
valueOf(String name)
以指定的名称返回此类型的枚举常量。static StandardOpenOption[]
values()
按照它们声明的顺序返回一个包含此枚举类型常量的数组。
-
-
-
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
- 如果参数为空
-
-