Работа с файлами в 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 ) );