【Java】Filesクラスによるファイル操作

2020年5月19日

本稿は、Java1.7より追加されたAPIであるFilesクラスで、Fileクラスよりも高度なファイル操作を行う方法について説明します。

Filesクラスは、基本的にPathクラスを引数にするメソッドを多く含みます。

Pathクラスは、FileクラスのtoPathメソッドや、Pathsクラスのgetメソッドでも生成できます。

また、PathクラスからtoFileメソッドでFileに変換することもできます。

今回はそのFilesクラス関連の機能の一部を説明します。

2017/12/25追記
findメソッド、newDirectoryStreamメソッドの戻り値は使用後にcloseを呼び出したほうが良いメソッドみたいなのでtry-with-resource構文を利用したサンプルに修正しました。

2020/05/19追記
椿様から、コンパイルエラーの、ご指摘を受け、walkFileTreeサンプルの修正を行いました。ご連絡ありがとうございます。

紹介する内容一覧



newDirectoryStreamメソッド

指定フォルダの中身のファイルとフォルダをPathの反復子で取得します。

まずは、testフォルダを作成します。

その中に、適当なファイルを入れて試します。

  1. import java.nio.file.Files;
  2. import java.nio.file.Paths;
  3. import java.nio.file.Path;
  4. import java.nio.file.DirectoryStream;
  5. import java.io.IOException;
  6.  
  7. public class Test{
  8. 	public static void main(String[] args)throws IOException{
  9. 		Path path = Paths.get("test");
  10. 		try( DirectoryStream<Path> ds = Files.newDirectoryStream(path) ){
  11. 			for ( Path p : ds ) {
  12. 				System.out.println(p);
  13. 			}
  14. 		} catch( IOException e ) {
  15. 			e.printStackTrace();
  16. 		}
  17. 	}
  18. }
実行結果

test\その他
test\僕.txt
test\画像.jpg
test\私.txt

フォルダの中身を表示することができました。

createDirectoryメソッド

Fileオブジェクトの示す場所にフォルダを作成します。

試しにやっほいフォルダを作成してみます。

  1. import java.nio.file.Files;
  2. import java.nio.file.Paths;
  3. import java.nio.file.Path;
  4. import java.io.IOException;
  5.  
  6. public class Test{
  7. 	public static void main(String[] args)throws IOException{
  8. 		Path path = Paths.get("やっほい");
  9. 		Files.createDirectory(path);
  10. 	}
  11. }
実行結果

やっほいフォルダが作成されましたね。

deleteメソッド

Fileオブジェクトの示す場所のファイルまたはフォルダを削除します。

やっほいフォルダを削除してみます。

  1. import java.nio.file.Files;
  2. import java.nio.file.Paths;
  3. import java.nio.file.Path;
  4. import java.io.IOException;
  5.  
  6. public class Test{
  7. 	public static void main(String[] args)throws IOException{
  8. 		Path path = Paths.get("やっほい");
  9. 		Files.delete(path);
  10. 	}
  11. }
実行結果

やっほいフォルダが削除されましたね。

moveメソッド

ファイルまたはフォルダを移動したり、名前変更したりできます。

テスト.txtファイルをやっほいフォルダに移動してみます。

  1. import java.nio.file.Files;
  2. import java.nio.file.Paths;
  3. import java.nio.file.Path;
  4. import java.io.IOException;
  5.  
  6. public class Test{
  7. 	public static void main(String[] args)throws IOException{
  8. 		Path src = Paths.get("テスト.txt");
  9. 		Path dest = Paths.get("やっほい/テスト.txt");
  10. 		Files.move(src,dest);
  11. 	}
  12. }
実行結果

先ほどあった、テスト.txtファイルがなくなりました。

やっほいフォルダの中身

テストファイルが移動されているようです。

copyメソッド

ファイルまたはフォルダをコピーします。

あいえお.txtファイルを作成しました。

  1. import java.io.IOException;
  2. import java.nio.file.Files;
  3. import java.nio.file.Path;
  4. import java.nio.file.Paths;
  5.  
  6. public class Test {
  7. 	public static void main(String[] args) throws IOException {
  8. 		Path src = Paths.get("あいえお.txt");
  9. 		Path dest = Paths.get("あいうえお.txt");
  10. 		Files.copy(src, dest);
  11. 	}
  12. }
  13.  
実行結果

あいえお.txtファイルをコピーした、あいうえお.txtファイルが作成されました。

readAllLinesメソッド

簡易的に文字列を読み込むことができます。

test.txtファイルを実行フォルダに作成し、内容を以下のようにして保存しました。

これを簡易的に読み込む方法が次のプログラムです。

  1. import java.io.IOException;
  2. import java.nio.file.Files;
  3. import java.nio.file.Path;
  4. import java.nio.file.Paths;
  5. import java.util.List;
  6.  
  7. public class Test {
  8.  
  9. 	public static void main(String[] args) throws IOException {
  10. 		Path path = Paths.get("test.txt");
  11. 		List<String> lines = Files.readAllLines(path);
  12. 		for ( String line : lines ) {
  13. 			System.out.println(line);
  14. 		}
  15. 	}
  16. }
実行結果

あいうえお
かきくけこ

保存ファイルがUTF8でない場合は、readAllLinesメソッドの第二引数の文字コードを保存ファイルの文字コード形式としっかり合わせることで読み込ませることができます。

writeメソッド

簡易的にテキストファイルを作成できます。

test.txtに何かテキストを書き出してみましょう。

  1. import java.io.IOException;
  2. import java.nio.file.Files;
  3. import java.nio.file.Path;
  4. import java.nio.file.Paths;
  5. import java.util.ArrayList;
  6.  
  7. public class Test {
  8.  
  9. 	public static void main(String[] args) throws IOException {
  10. 		Path path = Paths.get("test.txt");
  11. 		ArrayList<String> arr = new ArrayList<>();
  12. 		arr.add("こんちゃん");
  13. 		arr.add("おんちゃん");
  14. 		arr.add("あんちゃん");
  15. 		Files.write(path, arr);
  16. 	}
  17. }
実行結果

findメソッド

指定フォルダからの全階層ファイル、フォルダ検索が可能です。

今回は例として、画像という文字列を含むファイルのみを一覧で検索したいと思います。

流石に、キャプチャを全部乗せると見にくいので省略し、階層を以下のように作成しました。

  1. import java.io.IOException;
  2. import java.nio.file.Files;
  3. import java.nio.file.Path;
  4. import java.nio.file.Paths;
  5. import java.nio.file.attribute.BasicFileAttributes;
  6. import java.util.function.BiPredicate;
  7. import java.util.stream.Stream;
  8.  
  9. public class Test{
  10. 	public static void main(String[] args)throws IOException{
  11. 		Path path = Paths.get("test");
  12.  
  13. 		//検索オブジェクト(画像で、かつファイルの条件)
  14. 		BiPredicate<Path, BasicFileAttributes> bp =
  15. 				(p,a) -> p.toFile().getName().contains("画像") && a.isRegularFile();
  16.  
  17. 		//引数=(検索フォルダ, 再帰回数, 検索内容)
  18. 		try( Stream<Path> stream = Files.find(path, 2 ,bp) ){
  19. 			stream
  20. 			.map(e->e.toFile().getName())//検索結果をファイル名に変換
  21. 			.forEach(System.out::println);//検索結果表示
  22. 		} catch ( IOException e ) {
  23. 			e.printStackTrace();
  24. 		}
  25. 	}
  26. }
実行結果

あの画像.jpg
画像1.jpg
画像2.jpg
音楽画像.jpg

画像という文字を含むファイルのみを検索できていますね。

findメソッドの第二引数の数値は再帰回数です。

回数を多くすると、より深いフォルダまで検索していきます。

今回の例ならば、1に指定するとtestフォルダ内のフォルダとファイルのみが検索され、2に指定するともう一階層下の、画像フォルダと音楽フォルダ内部のファイルとフォルダまで検索してくれます。

そして、検索マッチに関する判断は第三引数に指定します。

(p,a)の左の引数がPathオブジェクトで右の引数がBasicFileAttributesオブジェクトになります。この二つの引数を使って検索に引っ掛けるか判定できます。BasicFileAttributesはファイル属性を表すオブジェクトであり、ファイルサイズ取得やフォルダかどうかなどの判断もできます。

今回の場合はp.toFile().getName().contains(“画像”)で画像を含むファイル名であり、かつ!a.isDirectory()でフォルダではないかを判定して検索に引っ掛けています。

walkFileTreeメソッド

指定フォルダからの全階層ファイル、フォルダの削除やコピーが可能です。

先ほど使用した階層を一斉コピーしたいとします。

コピー対象の階層

  1. import java.io.IOException;
  2. import java.nio.file.FileVisitResult;
  3. import java.nio.file.FileVisitor;
  4. import java.nio.file.Files;
  5. import java.nio.file.Path;
  6. import java.nio.file.Paths;
  7. import java.nio.file.attribute.BasicFileAttributes;
  8.  
  9. public class Test {
  10.  
  11. 	public static void main(String[] args) throws IOException {
  12. 		Path src = Paths.get("test");
  13. 		Path dest = Paths.get("テスト");
  14. 		Files.walkFileTree(src, new TestFileVisitor(src, dest));
  15. 	}
  16. }
  17. class TestFileVisitor implements FileVisitor<Path>{
  18.  
  19. 	final Path srcPath;
  20. 	final Path destPath;
  21. 	
  22. 	public TestFileVisitor(Path srcPath, Path destPath) {
  23. 		this.srcPath = srcPath;
  24. 		this.destPath = destPath;
  25. 	}
  26.  
  27. 	@Override
  28. 	//中のファイルやフォルダなどを処理する前に呼び出される
  29. 	public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) throws IOException {
  30. 		Path targetdir = destPath.resolve(srcPath.relativize(dir));
  31. 		Files.copy(dir,targetdir);
  32. 		return FileVisitResult.CONTINUE;
  33. 	}
  34.  
  35. 	@Override
  36. 	//実行すべきファイルの処理を記述する
  37. 	public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
  38. 		Files.copy(file, destPath.resolve(srcPath.relativize(file)));
  39. 		return FileVisitResult.CONTINUE;
  40. 	}
  41.  
  42. 	@Override
  43. 	//属性読み取り失敗時などに呼び出される
  44. 	public FileVisitResult visitFileFailed(Path file, IOException exc) throws IOException {
  45. 		return FileVisitResult.CONTINUE;
  46. 	}
  47.  
  48. 	@Override
  49. 	//フォルダ内のファイルやフォルダなどの処理が全て呼び出された後に呼び出される
  50. 	public FileVisitResult postVisitDirectory(Path dir, IOException exc) throws IOException {
  51. 		return FileVisitResult.CONTINUE;
  52. 	}
  53. 	
  54. }
実行結果

テストフォルダが作成されました。

中身もちゃんとコピーされています。

ここで出てきたFileVisitorインターフェースの実装により少しプログラムが長くなりましたが、内容はそこまで複雑ではありません。

walkFileTreeメソッドを呼び出すと引数に指定したパスにあるフォルダやファイルを順番にすべて確認していき、確認の度に第二引数のFileVisitorの特定のメソッドを呼び出します。

preVisitDirectoryは、そのフォルダの中身の確認をしに行く前に、呼び出されます。

visitFileはファイルが確認された時に呼び出されます。

visitFileFailedはファイルの属性読み取り失敗時などに呼び出されます。

postVisitDirectoryは、そのフォルダの中身のをすべて確認し終わった後に呼び出されます。

さて、コピーをフォルダごと実装する事を考えると、コピー先のフォルダが先に生成されなければなりませんよね？なので、今回はフォルダの中身を確認しに行く前にコピー元のフォルダを作成します。

これができそうなのはpreVisitDirectoryですよね。

そうするとfileVisitでファイル確認する時にはコピー先フォルダは既にできているはずです。なので普通にコピー処理を実装しておきます。

以上でフォルダコピーの簡易実装が完了しました。

せっかくなのでフォルダごと削除する方法も考えてみましょう。

フォルダを削除しようと思うと、中にファイルやフォルダが存在している状態では削除できません。

つまり、先ほどとは逆に中の物を先に削除し、最後にフォルダを削除する必要があります。

すべて処理した後に実行されるメソッドはpostVisitDirectoryでしたね。

ここにフォルダの削除処理を実装すればいいわけです。

それではコピーで作成したテストフォルダごと削除するサンプルをどうぞ。

  1. import java.io.IOException;
  2. import java.nio.file.FileVisitResult;
  3. import java.nio.file.FileVisitor;
  4. import java.nio.file.Files;
  5. import java.nio.file.Path;
  6. import java.nio.file.Paths;
  7. import java.nio.file.attribute.BasicFileAttributes;
  8.  
  9. public class Test {
  10.  
  11. 	public static void main(String[] args) throws IOException {
  12. 		Path path = Paths.get("テスト");
  13. 		Files.walkFileTree(path, new TestFileVisitor());
  14. 	}
  15. }
  16. class TestFileVisitor implements FileVisitor<Path>{
  17.  
  18. 	@Override
  19. 	//フォルダ内のファイルやフォルダなどを処理する前に呼び出される
  20. 	public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs) throws IOException {
  21. 		return FileVisitResult.CONTINUE;
  22. 	}
  23.  
  24. 	@Override
  25. 	//実行すべきファイルの処理を記述する
  26. 	public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
  27. 		Files.delete(file);
  28. 		return FileVisitResult.CONTINUE;
  29. 	}
  30.  
  31. 	@Override
  32. 	//ファイルの処理で属性が読み込めない時などに呼び出される
  33. 	public FileVisitResult visitFileFailed(Path file, IOException exc) throws IOException {
  34. 		return FileVisitResult.CONTINUE;
  35. 	}
  36.  
  37. 	@Override
  38. 	//フォルダ内のファイルやフォルダなどの処理が全て呼び出された後に呼び出される
  39. 	public FileVisitResult postVisitDirectory(Path dir, IOException exc) throws IOException {
  40. 		Files.delete(dir);
  41. 		return FileVisitResult.CONTINUE;
  42. 	}
  43. 	
  44. }
実行結果

テストフォルダが削除されました。

Java

Posted by nompor