Module java.base
Package java.nio.file

Enum Class 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
  • Enum Constant Details

    • READ

      public static final StandardOpenOption READ
      以读取访问方式打开。
    • WRITE

      public static final StandardOpenOption WRITE
      以写入访问方式打开。
    • APPEND

      public static final StandardOpenOption APPEND
      如果文件以写入访问方式打开,则字节将被写入文件的末尾而不是开头。

      如果文件被其他程序以写入访问方式打开,则写入文件末尾是否原子操作取决于文件系统。

    • TRUNCATE_EXISTING

      public static final StandardOpenOption TRUNCATE_EXISTING
      如果文件已经存在并以写入访问方式打开,则其长度将被截断为0。如果文件仅以读取访问方式打开,则此选项将被忽略。
    • 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
      要求对文件的每次更新都同步写入到底层存储设备的内容。
      参见:
  • Method Details

    • values

      public static StandardOpenOption[] values()
      返回包含此枚举类的常量的数组,按照它们声明的顺序排列。
      返回:
      包含此枚举类的常量的数组,按照它们声明的顺序排列
    • valueOf

      public static StandardOpenOption valueOf(String name)
      返回具有指定名称的此类的枚举常量。字符串必须与此类中用于声明枚举常量的标识符完全匹配。(不允许存在多余的空格字符。)
      参数:
      name - 要返回的枚举常量的名称。
      返回:
      具有指定名称的枚举常量
      抛出:
      IllegalArgumentException - 如果此枚举类没有具有指定名称的常量
      NullPointerException - 如果参数为null