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

当記事では、java.nio.fileパッケージを使った具体的な操作の一例として、Java上での以下のファイル操作について解説します。

【Java】java.nio.fileパッケージ(NIO.2)でも解説した通り、java.nio.fileパッケージは一般にjava.io.Fileクラスよりも高機能であり、多くの人にとっては使い勝手が良いものになると思います。

• ファイル・ディレクトリの作成
  
• ファイル・ディレクトリの存在チェック

java.nio.fileパッケージでのファイル操作の前提となるPathオブジェクトの詳しい生成方法については、以下を参照して下さい。

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

また、ファイル・ディレクトリの削除およびコピーについては、以下を参照して下さい。

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

また、ファイル名などのディレクトリに含まれるファイルの一覧の取得、ファイルの属性の取得といったファイル操作は以下の記事で解説します。

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

FileChannelを使ったファイルのコピーは、以下の記事で解説します。

【Java】FileChannelを使って高速にファイル入出力を行ってみた

Pathオブジェクトの作成

当記事では、java.nio.fileパッケージでのファイル操作を行う際に必要なPathオブジェクトを、java.nio.file.Pathsクラスのgetメソッドで生成します。

記述例は以下の通りです。

Path path = Paths.get("ファイルまたはディレクトリのパス");

Pathオブジェクトについての詳細は、以下の記事を参照して下さい。

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

ファイル・ディレクトリの作成

java.nio.fileパッケージでのファイル・ディレクトリの作成には、java.nio.file.FilesクラスのcreateFIleメソッド、createDirectoryメソッドを使います。

ファイル・ディレクトリを作成するメソッド

java.nio.file.FIlesクラスのうち、ファイル・ディレクトリの作成にかかわるメソッドは、主に以下が挙げられます。

可変長引数 FIleAttribute<?>... attrsは、アクセス権限などのファイル属性を表します。この詳細については、以下の記事で紹介しています。

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

createFileメソッドの記述例

Path path = Paths.get("作成したいファイルのパス");
Files.createFile(path);

createDirectoryメソッドの記述例

Path path = Paths.get("作成したいディレクトリのパス");
Files.createDirectory(path);

createDirectoriesメソッドの記述例

Path path = Paths.get("作成したいディレクトリのパス");
Files.createDirectories(path);

ファイルを作成するサンプルコード

public class createFileSample {
	public static void main(String[] args) {
		//Paths.getメソッドに作成したいファイルのパスとファイル名を渡します。
		Path filePath = Paths.get(".\\NIO\\sample1.txt");		
		try {
			//Files.createFileメソッドにPathオブジェクトを渡して、ファイルを作成します。
			Files.createFile(filePath);
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

ファイルを作成するサンプルコードの実行結果

Paths.getメソッドで指定したパスに、「sample1.txt」という空のテキストファイルが生成されます。

なお、上記のコードを続けて実行すると、java.nio.file.FileAlreadyExistsExceptionという例外が返ります。これは、すでに同じパスにファイルが存在することを表す例外です。

ディレクトリを作成するサンプルコード

public class createDirectorySample {
	public static void main(String[] args) {
		//Paths.getメソッドに作成したいディレクトリのパスを渡します。
		Path dir1 = Paths.get(".\\NIO\\aa");		
		//親ディレクトリも含めて作成したいディレクトリのパスを渡します。
		Path dir2 = Paths.get(".\\NIO\\bb\\cc");		
		try {
			//ディレクトリを作成します。
			Files.createDirectory(dir1);			
			//親ディレクトリも含めてディレクトリを作成します。
			Files.createDirectories(dir2);
		} catch (Exception e) {
			e.printStackTrace();
		}
	}
}

ディレクトリを作成するサンプルコードの実行結果

以下の通りにディレクトリが生成されます。

createDirectoryメソッドで空のディレクトリ、createDirectoriesメソッドで親ディレクトリも含めてディレクトリが作成されることが確認できます。

ファイル・ディレクトリの存在チェック

ファイルやディレクトリを操作する前などに、その存在をチェックしたい場合があります。この場合は、Filesクラスのexistsメソッド、またはnotExistsメソッドを使います。

ファイル・ディレクトリの存在チェックを行うメソッド

existsメソッド、notExistsメソッドの記述例

存在チェックを行いたいファイルまたはディレクトリのパスをexistメソッドまたはnotExistメソッドに渡します。

Path path = Paths.get("存在チェックを行いたいファイル、またはディレクトリのパス");
Files.exists(path);
Files.notExists(path);

ファイル・ディレクトリの存在チェックを行うサンプルコード

public class existCheckSample {
	public static void main(String[] args) {
		//存在するファイルのPathオブジェクトを作成します。
		Path existPath = Paths.get(".\\NIO\\sample1.txt");
		//存在しないファイルのPathオブジェクトを作成します。;
		Path notExistPath = Paths.get(".\\NIO\\notExist.txt");
		//存在するディレクトリを表すPathオブジェクトを作成します。
		Path dirPath = Paths.get(".\\NIO\\aa");
		//存在するファイルに対して存在チェックを行います。
		System.out.println(Files.exists(existPath));
		//存在しないファイルに対して存在チェックを行います。
		System.out.println(Files.exists(notExistPath));
		//存在するファイルに対して、存在しないことをチェックします。
		System.out.println(Files.notExists(existPath));
		//存在するディレクトリに対して存在チェックを行います。
		System.out.println(Files.exists(dirPath));
	}
}

ファイル・ディレクトリの存在チェックを行うサンプルコードの実行結果

コンソールに以下のように出力されます。

true
false
false
true

まとめ

当記事では、ファイル・ディレクトリの作成および存在チェックについて解説しました。

次のファイル・ディレクトリの削除およびコピーを紹介する記事を合わせて読むことをおすすめします。

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

関連記事：

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

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

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

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

【Java】java.io.Fileクラスの使い方(ファイル・ディレクトリ操作、パス、ファイル名、拡張子)

【Java】java.io.Fileクラスの使い方(ファイル一覧の取得、フィルタ)