Робота з файлами в Java

1. Клас Files

Щоб працювати з файлами, є шикарний утилітний клас — java.nio.file.Files. У нього є методи просто на всі випадки життя. Всі методи цього класу статичні і працюють з об'єктами типу Path. Методів дуже багато, тому ми розглянемо тільки основні:

Path createFile(Path path)

Path createDirectory(Path path)

Path createDirectories(Path path)

Path createTempFile(prefix, suffix)

Path createTempDirectory(prefix)

void delete(Path path)

Path copy(Path src, Path dest)

Path move(Path src, Path dest)

boolean isDirectory(Path path)

boolean isRegularFile(Path path)

boolean exists(Path path)

long size(Path path)

byte[] readAllBytes(Path path)

String readString(Path path)

List<String> readAllLines(Path path)

Path write(Path path, byte[])

Path writeString(Path path, String str)

DirectoryStream<Path> newDirectoryStream(Path dir)

2. Створення файлів та директорій

Файли та директорії створювати дуже просто. Переконаємося на прикладах:

Files.createFile(Path.of("c:\\readme.txt"));

Files.createDirectory(Path.of("c:\\test"));

Files.createDirectories(Path.of("c:\\test\\1\\2\\3"));

3. Копіювання, переміщення та видалення

Копіювати, переміщати та видаляти файли так само легко. На директорії це теж розповсюджується, але вони повинні бути порожні.

Path path1 = Path.of("c:\\readme.txt");
Path path2 = Path.of("c:\\readme-copy.txt");
Files.copy(path1, path2);

Path path1 = Path.of("c:\\readme.txt");
Path path2 = Path.of("d:\\readme-new.txt");
Files.move(path1, path2);

Path path = Path.of("d:\\readme-new.txt");
Files.delete(path);

4. Перевірка типу файлу та факту існування

Коли у тебе є якийсь шлях, отриманий ззовні, ти, ймовірно, захочеш знати, це файл чи директорія. Ну і загалом: існує такий файл/директорія чи ні?

Для цього теж є спеціальні методи. Також можна легко дізнатися довжину файлу:

Files.isRegularFile(Path.of("c:\\readme.txt"));

true

Files.isDirectory(Path.of("c:\\test"));

true

 Files.exists(Path.of("c:\\test\\1\\2\\3"));

false

Files.size(Path.of("c:\\readme.txt"));

10112

5. Робота з вмістом файлу

І нарешті, є ціла серія методів, які дозволяють легко прочитати або записати вміст файлу. Приклад:

Path path = Path.of("c:\\readme.txt");
List<String> list = Files.readAllLines(path);

for (String str : list)
   System.out.println(str);

6. Отримання вмісту директорії

Залишився ще найцікавіший метод — отримання файлів і піддиректорій у заданій директорії.

Для цього є спеціальний метод — newDirectoryStream(), який повертає спеціальний об'єкт типу DirectoryStream<Path>. У нього є ітератор(!), і за допомогою цього ітератора можна отримати всі файли та піддиректорії заданої директорії.

Виглядає простіше, ніж здається:

Path path = Path.of("c:\\windows");

try (DirectoryStream<Path> files = Files.newDirectoryStream(path)) {
   for (Path path : files)
      System.out.println(path);
}

Об'єкт DirectoryStream<Path> має дві властивості. По-перше, у нього є ітератор, який повертає шляхи до файлів, і ми можемо цей об'єкт використовувати всередині циклу for-each.

А по-друге, цей об'єкт є потоком даних, і його потрібно закривати за допомогою методу close(), ну або використовувати всередині try-with-resources.

7. Метод Files.newInputStream

Починаючи з Java 5 класи FileInputStream і FileOutputStream стали вважатися застарілими. Одним із їх мінусів було те, що при створенні об'єкта цих класів одразу відбувається створення файлів на диску. І потенційно викидаються всі помилки, пов'язані зі створенням файлів.

Згодом це було визнано не найкращим рішенням. Тому для створення об'єктів-файлів рекомендується використовувати методи утилітного класу – java.nio.Files.

Ось порівняння старого підходу до створення файлів і нового:

String src = "c:\\projects\\log.txt";
InputStream input = new FileInputStream( src );

String src = "c:\\projects\\log.txt";
InputStream input = Files.newInputStream( Path.of( src ) );

Аналогічно заміна і для FileOutputStream:

String src = "c:\\projects\\log.txt";
OutputStream  output = new FileOutputStream( src );

String src = "c:\\projects\\log.txt";
OutputStream  output = Files.newOutputStream( Path.of( src ) );