java.nio.file

列挙 StandardOpenOption

java.lang.Object

java.lang.Enum<StandardOpenOption>

java.nio.file.StandardOpenOption

すべての実装されたインタフェース:

Serializable, Comparable<StandardOpenOption>, OpenOption

public enum StandardOpenOption
extends Enum<StandardOpenOption>
implements OpenOption

標準オープンオプションを定義します。

導入されたバージョン:

1.7

列挙型定数のサマリー

列挙型定数

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

メソッドのサマリー

メソッド

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

クラス java.lang.Enum から継承されたメソッド

clone, compareTo, equals, finalize, getDeclaringClass, hashCode, name, ordinal, toString, valueOf

クラス java.lang.Object から継承されたメソッド

getClass, notify, notifyAll, wait, wait, wait

列挙型定数の詳細

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()

この列挙型の定数を含む配列を、宣言されている順序で返します。このメソッドは、次のようにして定数を反復するために使用できます。

for (StandardOpenOption c : StandardOpenOption.values())
    System.out.println(c);

戻り値:

この列挙型の定数を含む配列を宣言されている順序で

valueOf

public static StandardOpenOption valueOf(String name)

指定された名前を持つ、この型の列挙型定数を返します。文字列は、この型の列挙型定数を宣言するのに使用した識別子と厳密に一致している必要があります。不適切な空白文字は許可されません。

パラメータ:

name - 返される列挙型定数の名前。

戻り値:

指定された名前を持つ列挙型定数

例外:

IllegalArgumentException - 指定された名前を持つ定数をこの列挙型が持っていない場合

NullPointerException - 引数が null の場合