Module  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 - 如果参数为空