【Java】Pathオブジェクトを生成する方法(java.nio.fileパッケージ)

java.nio.fileパッケージを用いたJava上でのファイル操作は、基本的に以下のような手順になります。

• FileSystemクラスのgetPathメソッド、またはPathクラスのgetメソッドで、ファイルやディレクトリの場所を表すPathオブジェクトを生成する
• 　↓
• Filesクラスで実際のファイル操作を行う

上記のうち、当記事では、Filesクラスで実際のファイル操作を行う前段階となる、Pathオブジェクトを生成する以下の二通りの方法について解説します。

• FileSystemクラスのgetPathメソッドを使う方法
• Pathクラスのgetメソッドを使う方法

また、java.io.Fileオブジェクトと、java.nio.file.Pathオブジェクトを相互に変換する方法についても紹介します。

• FileオブジェクトからPathオブジェクトを生成する方法
• PathオブジェクトからFileオブジェクトを生成する方法

java.nio.fileパッケージの概要について知りたい方は、以下の記事を参照して下さい。

【Java】java.nio.fileパッケージ(NIO.2)

また、PathオブジェクトとFilesクラスを使った具体的なファイル操作は、以下の記事を参照して下さい。

【Java】java.nio.fileパッケージの使用例①(ファイルの作成、存在チェック)

【Java】java.nio.fileパッケージの使用例②(移動・コピー、削除)

【Java】java.nio.fileパッケージの使用例③(ファイル属性の取得・変更)

FileSystemsクラス、FileSystemクラス

名前が似ててややこしいですが、FileSystemクラスはFileSystemsクラスのメソッドから取得されるクラスです。FIleSystemsクラスからFileSystemクラスを取得し、FIleSystemクラスのgetPathメソッドを呼び出すことで、Pathオブジェクトを生成します。

FileSystemsクラス

FileSystemsクラスは、実行している環境でアクセス可能なファイルシステム(デフォルトのファイルシステム)を返す、以下のようなgetDefault()メソッドを定義しています。

FileSystemsクラスのメソッドの記述例

FileSystem fs = FileSystems.getDefault();

FileSystemクラス

Pathオブジェクトを生成するgetPathメソッドの他、ファイルにアクセスするための様々なメソッドを持ちます。主要なものを以下の表にまとめました。

FileSystem.getPathメソッドの記述例

//デフォルトのファイルシステムを取得します。
FileSystem fs = FileSystems.getDefault();

//Pathオブジェクトを作成します。getPathメソッドに渡したパスにファイルやディレクトリが存在するかどうかは問いません。
Path path1 = fs.getPath(".\\NIO1.txt");

//ディレクトリの場合は以下のように記述します。
Path path2 = fs.getPath("C:\\JavaWorkspace\\Works");

//文字列を分割して指定することも可能です。
Path path3 = fs.getPath("C:\\JavaWorkspace\\Works\\", "NIO2.txt");

//文字列の最後に区切り文字を入れずに引数に渡すと、カンマの箇所に自動的に区切り文字を補完します。
Path path4 = fs.getPath("C:", "JavaWorkspace", "Works", "NIO3.txt");

その他FileSystemsクラスのメソッドの記述例

//ファイルシステム上での区切り文字を返します。Windows環境で実行すると、通常は「\」が返ります。
String sep = fs.getSeparator()

//getRootDirectories()は、Iterable<path>型の返り値を返すので、
//for-each文を使ってループ処理をするなどして処理を行います。
Iterable<Path> roots = fs.getRootDirectories();

FileSystemクラスの応用例

FileSystemクラスのメソッドについて、具体的な使用例を紹介します。以下のサンプルコードでは、

• ファイルシステムで使われる区切り文字の取得
• 現在ファイルシステムで使われているルートディレクトリの取得

を行っています。getPathメソッドで生成したPathオブジェクトを使った実際のファイル操作については、以下の記事を参照して下さい。

ー

getSeparatorメソッドとgetRootDirectoriesメソッドのサンプルコード

import java.nio.file.FileSystem;
import java.nio.file.FileSystems;
import java.nio.file.Path;

public class FileSystemSample {
	public static void main(String[] args) {
		//デフォルトのファイルシステムを取得します。
		FileSystem fs = FileSystems.getDefault();

		//ファイルシステムで使われる区切り文字をコンソールに出力します。
		System.out.println("このファイルシステムの区切り文字は " + fs.getSeparator() + " です。");

		//現在ファイルシステムで使用しているルートディレクトリをすべてコンソールに出力します。
		for (Path root : fs.getRootDirectories()) {
			System.out.println(root);
		}
	}
}

getSeparatorメソッドとgetRootDirectoriesメソッドのサンプルコードの実行結果

上記のコードを実行すると、コンソールに以下のように出力されます。

このファイルシステムの区切り文字は \ です。
C:\
D:\
E:\
F:\

Pathsクラス

Pathsクラスは、Pathオブジェクトを生成するstaticメソッドのみを実装したクラスになります。FilesystemクラスのgetPathメソッドを呼び出すよりも短く記述が出来るので、普段はこちらを使うのが良いでしょう。

Paths.getメソッドの記述例

FilesystemクラスのgetPathメソッドとほぼ同様の使い方をします。

//Pathオブジェクトを作成します。getメソッドに渡したパスにファイルやディレクトリが存在するかどうかは問いません。
Path path1 = Paths.get(".\\NIO1.txt");

//ディレクトリの場合は以下のように記述します。
Path path2 = Paths.get("C:\\JavaWorkspace\\Works");

//文字列を分割して指定することも可能です。
Path path3 = Paths.get("C:\\JavaWorkspace\\Works\\", "NIO2.txt");

//文字列の最後に区切り文字を入れずに引数に渡すと、カンマの箇所に自動的に区切り文字を補完します。
Path path4 = Paths.get("C:", "JavaWorkspace", "Works", "NIO3.txt");

Fileオブジェクトとの互換性

java.io.Fileオブジェクトと、java.nio.file.Pathオブジェクトは相互に変換可能です。

FileオブジェクトからPathオブジェクトへの変換

FileオブジェクトからPathオブジェクトに変換するには、FileクラスのtoPathメソッドを使います。

toPathメソッドの記述例

//FileオブジェクトをPathオブジェクトに変換します。
File file = new File("ファイルのパス");
Path path = file.toPath();

PathオブジェクトからFileオブジェクトへの変換

PathオブジェクトからFileオブジェクトに変換するには、PathインターフェースのtoFileメソッドを使います。

toFileメソッドの記述例

//PathオブジェクトをFileオブジェクトに変換します。
Path path = Paths.get("ファイルのパス");
File file = path.toFile();

まとめ

当記事では、Pathオブジェクトの生成方法について、2通りの方法を解説しました。また、FileオブジェクトとPathオブジェクトを相互に変換する方法について解説しました。

java.nio.filesパッケージは、ファイルやディレクトリの場所のみを示すPathオブジェクトと、ファイル操作を行うメソッドを集めたFilesクラスというように分かれています。java.ioパッケージと比べて仕組みは複雑に見えますが、java.nio.filesパッケージには便利なメソッドが多く用意されており、実際のコードは簡潔に書くことが出来ます。まずはjava.nio.filesパッケージにおけるファイル操作の起点となるPathオブジェクトについて理解すれば、一見難しいように見えるNIO.2についても理解がしやすいと思います。

関連記事：

【Java】java.nio.fileパッケージ(NIO.2)

【Java】java.nio.fileパッケージの使用例①(ファイルの作成、存在チェック)

【Java】java.nio.fileパッケージの使用例②(移動・コピー、削除)

【Java】java.nio.fileパッケージの使用例③(ファイル属性の取得・変更)