列挙型クラス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クラスで宣言されたネストされたクラス/インタフェース

    Enum.EnumDesc<E>
    修飾子と型
    クラス
    説明
    static final class 
    Enum.EnumDesc<E extends Enum<E>>
    enum定数の「名目記述子」。

  • 列挙型定数のサマリー

    列挙型定数
    列挙型定数
    説明
    APPEND
    ファイルがWRITE用に開かれた場合、バイトはファイルの先頭ではなく最後に書き込まれます。
    CREATE
    ファイルが存在しない場合は新しいファイルを作成します。
    CREATE_NEW
    新しいファイルを作成し、ファイルがすでに存在する場合は失敗します。
    DELETE_ON_CLOSE
    閉じるときに削除します。
    DSYNC
    ファイルの内容の更新は、基本となる記憶装置に同期的に書き込まれることを必要とします。
    READ
    読込みアクセス用に開きます。
    SPARSE
    スパース・ファイルです。
    SYNC
    ファイルの内容またはメタデータの更新は、基本となる記憶装置に同期的に書き込まれることを必要とします。
    TRUNCATE_EXISTING
    ファイルがすでに存在し、WRITEアクセス用に開かれた場合、その長さが0に切り詰められます。
    WRITE
    書込みアクセス用に開きます。

  • メソッドのサマリー

    修飾子と型
    メソッド
    説明
    static StandardOpenOption
    valueOf(String name)
    指定された名前を持つこのクラスのenum定数を返します。
    static StandardOpenOption[]
    values()
    この列挙クラスの定数を含む配列を宣言されている順序で 返します。

    Enumクラスで宣言されたメソッド

    clone, compareTo, describeConstable, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf
    修飾子と型
    メソッド
    説明
    protected final Object
    clone()
    CloneNotSupportedExceptionをスローします。
    final int
    compareTo(StandardOpenOption o)
    このenumと指定されたオブジェクトの順序を比較します。
    final Optional<Enum.EnumDesc<StandardOpenOption>>
    describeConstable()
    このインスタンスの列挙型記述子EnumDescを返します(作成可能な場合)。作成できない場合は空のOptionalを返します。
    final boolean
    equals(Object other)
    指定されたオブジェクトがこのenum定数と同じ場合は、trueを返します。
    protected final void
    finalize()
    削除予定のため非推奨: このAPI要素は、将来のバージョンで削除される可能性があります。
    最終決定は削除のために非推奨になりました。
    final Class<StandardOpenOption>
    getDeclaringClass()
    このenum定数のenum型に対応するClassオブジェクトを返します。
    final int
    hashCode()
    このenum定数のハッシュ・コードを返します。
    final String
    name()
    enum宣言で宣言されているとおりのenum定数の名前を返します。
    final int
    ordinal()
    列挙定数の序数(列挙宣言での位置。初期定数はゼロの序数に割り当てられる)を返します。
    String
    toString()
    宣言に含まれるとおりのenum定数の名前を返します。
    static <T extends Enum<T>>
    T
    valueOf(Class<T> enumClass, String name)
    指定された名前の指定されたenumクラスのenum定数を返します。

    クラスオブジェクトで宣言されたメソッド

    getClass, notify, notifyAll, wait, wait, wait
    修飾子と型
    メソッド
    説明
    final Class<?>
    getClass()
    このObjectの実行時クラスを返します。
    final void
    notify()
    このオブジェクトのモニターで待機中のスレッドを1つ再開します。
    final void
    notifyAll()
    このオブジェクトのモニターで待機中のすべてのスレッドを再開します。
    final void
    wait()
    現在のスレッドが目覚めるまで待機します。通常、notifiedまたはinterruptedです。
    final void
    wait(long timeoutMillis)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。
    final void
    wait(long timeoutMillis, int nanos)
    現在のスレッドは、通常、notifiedまたはinterruptedであるか、一定のリアルタイムが経過するまで、目覚めるまで待機します。

  • 列挙型定数の詳細

    • 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
      ファイルの内容またはメタデータの更新は、基本となる記憶装置に同期的に書き込まれることを必要とします。
      関連項目:

    • DSYNC

      public static final StandardOpenOption DSYNC
      ファイルの内容の更新は、基本となる記憶装置に同期的に書き込まれることを必要とします。
      関連項目:

  • メソッドの詳細

    • values

      public static StandardOpenOption[] values()
      この列挙クラスの定数を含む配列を宣言されている順序で 返します。
      戻り値:
      この列挙クラスの定数を宣言されている順序で含む配列

    • valueOf

      public static StandardOpenOption valueOf(String name)
      指定された名前を持つこのクラスのenum定数を返します。 文字列は、このクラスでenum定数を宣言するために使用される識別子と正確に一致する必要があります。 (不適切な空白文字は許可されません。)
      パラメータ:
      name - 返される列挙型定数の名前。
      戻り値:
      指定された名前を持つ列挙型定数
      スロー:
      IllegalArgumentException - この列挙型クラスに指定された名前の定数がない場合
      NullPointerException - 引数がnullの場合