パッケージ java.nio.file

ファイル、ファイル属性、およびファイルシステムにアクセスするための Java 仮想マシン用のインタフェースとクラスを定義します。

参照: 説明

インタフェースのサマリー

インタフェース	説明
CopyOption	ファイルのコピーまたは移動する方法を構成するオブジェクトです。
DirectoryStream<T>	ディレクトリ内のエントリに対して反復処理を行うためのオブジェクトです。
DirectoryStream.Filter<T>	ディレクトリエントリを受け入れるべきかフィルタするべきかを判断するオブジェクトによって実装されるインタフェースです。
FileVisitor<T>	ファイルのビジターです。
OpenOption	ファイルの開くまたは作成する方法を構成するオブジェクトです。
Path	ファイルシステム内のファイルを特定するために使用可能なオブジェクトです。
PathMatcher	パスの照合操作を実行するオブジェクトによって実装されるインタフェースです。
SecureDirectoryStream<T>	開いたディレクトリから相対的な位置にあるファイルに対する操作を定義する DirectoryStream です。
Watchable	変更およびイベントを監視できるように、監視サービスに登録できるオブジェクトです。
WatchEvent<T>	WatchService に登録されたオブジェクトに対するイベントまたは繰り返されるイベントです。
WatchEvent.Kind<T>	イベントの種類 (識別目的) です。
WatchEvent.Modifier	Watchable が WatchService にどのように登録されるかを修飾するイベント修飾子です。
WatchKey	watchable オブジェクトが WatchService に登録されていることを示すトークンです。
WatchService	登録されたオブジェクトの変更およびイベントを監視する監視サービスです。

クラスのサマリー

クラス	説明
Files	このクラスは、ファイル、ディレクトリ、またはその他の種類のファイルを操作する static メソッドだけで構成されます。
FileStore	ファイル用のストレージです。
FileSystem	ファイルシステムへのインタフェースを提供し、ファイルシステム内のファイルやその他のオブジェクトにアクセスするためのオブジェクトのファクトリです。
FileSystems	ファイルシステム用のファクトリメソッドです。
LinkPermission	リンク作成操作のための Permission クラスです。
Paths	このクラスは、パス文字列または URI を変換することによって Path を返す static メソッドのみで構成されます。
SimpleFileVisitor<T>	すべてのファイルをビジットして入出力エラーを再度スローするというデフォルトの動作を持つ、簡単なファイルビジターです。
StandardWatchEventKinds	標準イベントの種類を定義します。

列挙型のサマリー

列挙型	説明
AccessMode	ファイルのアクセシビリティーのテストに使用されるアクセスモードを定義します。
FileVisitOption	ファイルツリートラバーサルオプションを定義します。
FileVisitResult	FileVisitor の結果型です。
LinkOption	シンボリックリンクの処理方法を定義します。
StandardCopyOption	標準コピーオプションを定義します。
StandardOpenOption	標準オープンオプションを定義します。

例外のサマリー

Exception	説明
AccessDeniedException	通常はファイルアクセス権またはその他のアクセスチェックのために、ファイルシステム操作が拒否されたときにスローされるチェック例外です。
AtomicMoveNotSupportedException	原子的なファイルシステム操作としてファイルを移動できない場合にスローされるチェック例外です。
ClosedDirectoryStreamException	閉じられたディレクトリストリームに対する操作を呼び出そうとしたときにスローされる非チェック例外です。
ClosedFileSystemException	閉じられたファイルやファイルシステムに対する操作を呼び出そうとしたときにスローされる非チェック例外です。
ClosedWatchServiceException	閉じられた監視サービスに対する操作を呼び出そうとしたときにスローされる非チェック例外です。
DirectoryIteratorException	ディレクトリ内のエントリに対する反復処理を行っているときに入出力エラーが検出された場合にスローされる実行時例外です。
DirectoryNotEmptyException	ディレクトリが空でないためにファイルシステム操作が失敗した場合にスローされるチェック例外です。
FileAlreadyExistsException	ファイルまたはディレクトリの作成を試みたときにその名前のファイルがすでに存在している場合にスローされるチェック例外です。
FileSystemAlreadyExistsException	すでに存在するファイルシステムを作成しようとしたときにスローされる実行時例外です。
FileSystemException	1 つまたは 2 つのファイルでファイルシステム操作が失敗した場合にスローされます。
FileSystemLoopException	ファイルシステムのループ、すなわちサイクルが検出された場合にスローされるチェック例外です。
FileSystemNotFoundException	ファイルシステムが見つからない場合にスローされる実行時例外です。
InvalidPathException	パス文字列に無効な文字が含まれているか、その他のファイルシステム固有の理由でパス文字列が無効であるために、パス文字列を Path に変換できない場合にスローされる非チェック例外です。
NoSuchFileException	存在しないファイルへのアクセスを試みた場合にスローされるチェック例外です。
NotDirectoryException	ファイルがディレクトリでないために、ディレクトリを対象にしたファイルシステム操作が失敗した場合にスローされるチェック例外です。
NotLinkException	ファイルがシンボリックリンクでないためにファイルシステム操作が失敗した場合にスローされるチェック例外です。
ProviderMismatchException	あるファイルシステムプロバイダで作成されたオブジェクト上で、別のファイルシステムプロバイダで作成されたパラメータを指定してメソッドを呼び出そうとした場合にスローされる非チェック例外です。
ProviderNotFoundException	必要な型のプロバイダが見つからない場合にスローされる実行時例外です。
ReadOnlyFileSystemException	read-only の FileSystem に関連付けられているオブジェクトを更新しようとしたときにスローされる非チェック例外です。

パッケージ java.nio.file の説明

ファイル、ファイル属性、およびファイルシステムにアクセスするための Java 仮想マシン用のインタフェースとクラスを定義します。

java.nio.file パッケージは、ファイルおよびファイルシステムにアクセスするためのクラスを定義します。ファイル属性やファイルシステム属性にアクセスするための API は、java.nio.file.attribute パッケージに定義されています。java.nio.file.spi パッケージは、プラットフォームのデフォルトプロバイダを拡張したり、他のプロバイダ実装を構築したりするサービスプロバイダの実装者によって使用されます。

シンボリックリンク

多くのオペレーティングシステムおよびファイルシステムで、シンボリックリンク がサポートされています。シンボリックリンクとは、別のファイルへの参照として機能する特殊ファイルです。ほとんどの場合、アプリケーションではシンボリックリンクを意識する必要はなく、シンボリックリンクに対する操作はそのリンクのターゲットに自動的にリダイレクトされます。ただし、シンボリックリンクを削除したり、名前変更または移動したりする場合は例外で、その場合はそのリンクのターゲットではなく、そのリンクが削除または除去されます。このパッケージには、実装でこれらのセマンティクスを実現するシンボリックリンクのサポートが含まれています。ファイルシステムでは意味的に似通った他の種類のリンクをサポートしていることがありますが、それらのリンクのサポートはこのパッケージには含まれていません。

相互運用性

File クラスでは、java.io.File オブジェクトで表される抽象パスを変換することによって Path を構築する toPath メソッドを定義します。結果の Path を使用すると、File オブジェクトと同じファイルを操作できます。Path の仕様には、Path と java.io.File オブジェクトとの相互運用性に関する詳細情報が記載されています。

Visibility

このパッケージ内のクラスによって提供されるファイルやファイルシステムのビューは、同じ Java 仮想マシン内の他のインスタンスによって提供される他のビューと矛盾しないことが保証されています。しかし、ベースとなるオペレーティングシステムのキャッシュ処理や、ネットワークファイルシステムプロトコルによる遅延が原因で、そのビューと、並行して実行されているプログラムで認識されるファイルシステムのビューが矛盾する可能性がないわけではありません。この問題は、これらのプログラムを記述している言語の違いや、これらが同一マシンで実行されているかどうかとは関係なく発生します。こうした矛盾は、システムによって生じるものであるため未指定です。

同期入出力ファイル整合性

SYNC および DSYNC オプションは、ファイルへの更新がベースとなるストレージデバイスにも同時に書き込まれる必要があるファイルを開く場合に使用されます。デフォルトプロバイダの場合で、ファイルがローカルストレージデバイスに格納されていて、シーク可能なチャネルがこれらのオプションのいずれかを使用して開いたファイルに接続されている場合、write メソッドの呼び出しは、その呼び出しによってファイルに加えられたすべての変更がそのデバイスにも書き込まれた場合にのみ返します。これらのオプションは、万一システムクラッシュが発生した場合に重要な情報が失われることがないようにするのに役立ちます。一方、ファイルがローカルのデバイス上にない場合、書き込みは行われません。この保証が他のプロバイダ実装でも適用可能かどうかはプロバイダに固有のものです。

一般的な例外

特に指定がないかぎり、このパッケージ内のクラスまたはインタフェースのメソッドやコンストラクタに null 引数を渡すと、NullPointerException がスローされます。また、特に指定がないかぎり、null 要素を含むコレクションでメソッドを呼び出しても、NullPointerException がスローされます。

特に指定がないかぎり、ファイルシステムへのアクセスを試みるメソッドは、クローズされている FileSystem に関連付けられたオブジェクトに対して呼び出されると、ClosedFileSystemException をスローします。また、ファイルシステムへの書き込みアクセスを試みるメソッドはすべて、読み取り専用アクセスのみを提供する FileSystem に関連付けられたオブジェクトに対して呼び出されると、ReadOnlyFileSystemException をスローします。

特に指定がないかぎり、このパッケージ内のクラスまたはインタフェースのメソッドのうち、あるプロバイダによって別のプロバイダが作成したオブジェクトを示すパラメータで作成されたものを呼び出すと、ProviderMismatchException がスローされます。

オプションの固有例外

このパッケージ内のクラスで定義されている、ファイルシステムにアクセスするメソッドのほとんどは、入出力エラーが発生した場合に IOException がスローされるように指定します。場合によっては、これらのメソッドが特定の入出力例外を一般的なケース用に定義することがあります。これらの例外 (オプションの固有例外として知られている) は、実装が特定のエラーを検出できた場合にそれによってスローされます。特定のエラーを検出できない場合は、より一般的な IOException がスローされます。

導入されたバージョン:

1.7