Интерфейс FileVisitor<T>

public interface FileVisitor<T>

Посетитель файлов. Реализация этого интерфейса предоставляется методам Files.walkFileTree для посещения каждого файла в дереве файлов.

Примеры использования: Предположим, мы хотим удалить дерево файлов. В этом случае каждый каталог должен быть удален после удаления элементов в каталоге.

Path start = ...
     Files.walkFileTree(start, new SimpleFileVisitor<Path>() {
         @Override
         public FileVisitResult visitFile(Path file, BasicFileAttributes attrs)
             throws IOException
         {
             Files.delete(file);
             return FileVisitResult.CONTINUE;
         }
         @Override
         public FileVisitResult postVisitDirectory(Path dir, IOException e)
             throws IOException
         {
             if (e == null) {
                 Files.delete(dir);
                 return FileVisitResult.CONTINUE;
             } else {
                 // directory iteration failed
                 throw e;
             }
         }
     });

Кроме того, предположим, что мы хотим скопировать дерево файлов в целевую папку. В этом случае должны следовать символические ссылки, а целевой каталог должен быть создан перед копированием элементов в каталоге.

final Path source = ...
     final Path target = ...

     Files.walkFileTree(source, EnumSet.of(FileVisitOption.FOLLOW_LINKS), Integer.MAX_VALUE,
         new SimpleFileVisitor<Path>() {
             @Override
             public FileVisitResult preVisitDirectory(Path dir, BasicFileAttributes attrs)
                 throws IOException
             {
                 Path targetdir = target.resolve(source.relativize(dir));
                 try {
                     Files.copy(dir, targetdir);
                 } catch (FileAlreadyExistsException e) {
                      if (!Files.isDirectory(targetdir))
                          throw e;
                 }
                 return CONTINUE;
             }
             @Override
             public FileVisitResult visitFile(Path file, BasicFileAttributes attrs)
                 throws IOException
             {
                 Files.copy(file, target.resolve(source.relativize(file)));
                 return CONTINUE;
             }
         });

Методы

preVisitDirectory

FileVisitResult preVisitDirectory(T dir,
                                  BasicFileAttributes attrs)
                           throws IOException

Параметры:

dir - ссылка на каталог

attrs - базовые атрибуты каталога

Возвращает:

результат посещения

Исключение:

IOException - если произошла ошибка ввода-вывода

visitFile

FileVisitResult visitFile(T file,
                          BasicFileAttributes attrs)
                   throws IOException

Вызывается для файла в каталоге.

Параметры:

file - ссылка на файл

attrs - базовые атрибуты файла

Возвращает:

результат посещения

Исключение:

IOException - если произошла ошибка ввода-вывода

visitFileFailed

FileVisitResult visitFileFailed(T file,
                                IOException exc)
                         throws IOException

Вызывается для файла, который не удалось посетить. Этот метод вызывается, если атрибуты файла не удалось прочитать, файл является каталогом, который не удалось открыть, и по другим причинам.

Параметры:

file - ссылка на файл

exc - исключение ввода-вывода, которое помешало посетить файл

Возвращает:

результат посещения

Исключение:

IOException - если произошла ошибка ввода-вывода

postVisitDirectory

FileVisitResult postVisitDirectory(T dir,
                                   IOException exc)
                            throws IOException

Вызывается для каталога после посещения элементов в каталоге и всех его потомков. Этот метод также вызывается, когда итерация по каталогу завершается преждевременно (методом visitFile, возвращающим SKIP_SIBLINGS, или при ошибке ввода-вывода во время итерации по каталогу).

Параметры:

dir - ссылка на каталог

exc - null если итерация по каталогу завершилась без ошибки; в противном случае исключение ввода-вывода, которое вызвало преждевременное завершение итерации по каталогу

Возвращает:

результат посещения

Исключение:

IOException - если произошла ошибка ввода-вывода