模块  java.base
软件包  java.nio.file

Enum StandardOpenOption

    • Enum Constant Detail

      • 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方法关闭时删除该文件。 如果未调用close方法,则会尽力尝试在Java虚拟机终止时删除该文件(通常,如Java语言规范所定义,或者在可能的情况下,异常)。 此选项主要用于仅由Java虚拟机的单个实例使用的工作文件 建议在打开其他实体同时打开的文件时,不建议使用此选项。 关于何时以及如何删除文件的许多细节都是特定于实现的,因此未指定。 特别是,实现可能无法保证在文件打开时由攻击者替换时删除预期文件。 因此,使用此选项时,安全敏感应用程序应该小心。

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

      • SPARSE

        public static final StandardOpenOption SPARSE
        稀疏文件。 CREATE_NEW选项一起使用时,此选项会提示新文件将是稀疏的。 当文件系统不支持创建稀疏文件时,将忽略该选项。
    • 方法详细信息

      • 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