モジュール java.base

パッケージ java.nio.file

列挙型クラス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

ネストされたクラスのサマリー

クラスjava.lang.Enumで宣言されたネストされたクラス/インタフェース

Enum.EnumDesc<E extends Enum<E>>

列挙型定数のサマリー

列挙型定数

列挙型定数	説明
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()	この列挙クラスの定数を含む配列を宣言されている順序で 返します。

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

clone, compareTo, describeConstable, 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()

この列挙クラスの定数を含む配列を宣言されている順序で 返します。

戻り値:

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

valueOf

public static StandardOpenOption valueOf(String name)

指定された名前を持つこのクラスのenum定数を返します。 文字列は、このクラスでenum定数を宣言するために使用される識別子と正確に一致する必要があります。 (不適切な空白文字は許可されません。)

パラメータ:

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

戻り値:

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

例外:

IllegalArgumentException - この列挙型クラスに指定された名前の定数がない場合

NullPointerException - 引数がnullの場合