Робота з файлами в 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  input = new FileOutputStream( src );

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