StandardOpenOption (Java Platform SE 8 )

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 and Description
`APPEND` 如果文件打开 `WRITE`访问，则字节将被写入文件的末尾而不是开头。
`CREATE` 创建一个新文件（如果不存在）。
`CREATE_NEW` 创建一个新的文件，如果该文件已经存在失败。
`DELETE_ON_CLOSE` 关闭时删除。
`DSYNC` 要求将文件内容的每次更新都与底层存储设备同步写入。
`READ` 打开阅读权限。
`SPARSE` 稀疏文件
`SYNC` 要求将文件内容或元数据的每次更新都同步写入底层存储设备。
`TRUNCATE_EXISTING` 如果文件已经存在，并且打开 `WRITE`访问，则其长度将截断为0。
`WRITE` 打开以进行写入。

方法摘要

所有方法静态方法具体的方法
Modifier and Type	Method and Description
`static StandardOpenOption`	`valueOf(String name)` 以指定的名称返回此类型的枚举常量。
`static StandardOpenOption[]`	`values()` 按照它们声明的顺序返回一个包含此枚举类型常量的数组。

Methods inherited from class java.lang.Enum
clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

Methods inherited from class java.lang.Object
getClass, notify, notifyAll, wait, wait, wait

- 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
```
    如果文件已存在，并且打开 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选项一起使用时，此选项提供了一个提示，新文件将是稀疏的。当文件系统不支持创建稀疏文件时，该选项将被忽略。
  - SYNC
```
public static final StandardOpenOption SYNC
```
    要求将文件内容或元数据的每次更新都同步写入底层存储设备。
    
    另请参见：
    
    Synchronized I/O file integrity
  - DSYNC
```
public static final StandardOpenOption DSYNC
```
    要求将文件内容的每次更新都与底层存储设备同步写入。
    
    另请参见：
    
    Synchronized I/O file integrity
- 方法详细信息
  - values
```
public static StandardOpenOption[] values()
```
    按照它们声明的顺序返回一个包含此枚举类型常量的数组。该方法可用于遍历常量如下：
```
  for (StandardOpenOption c : StandardOpenOption.values())
    System.out.println(c); 
```
    结果
    
    一个包含这个枚举类型的常量的数组，按照它们被声明的顺序
  - valueOf
```
public static StandardOpenOption valueOf(String name)
```
    以指定的名称返回此类型的枚举常量。字符串必须完全匹配用于声明此类型的枚举常量的标识符。（不允许使用外来空白字符。）
    
    参数
    
    name - 要返回的枚举常量的名称。
    
    结果
    
    具有指定名称的枚举常数
    
    异常
    
    IllegalArgumentException - 如果此枚举类型没有指定名称的常量
    
    NullPointerException - 如果参数为空

Enum StandardOpenOption

Enum Constant Summary

方法摘要

Methods inherited from class java.lang.Enum

Methods inherited from class java.lang.Object

Enum Constant Detail

READ

WRITE

APPEND

TRUNCATE_EXISTING

CREATE

CREATE_NEW

DELETE_ON_CLOSE

SPARSE

SYNC

DSYNC

方法详细信息

values

valueOf