fileVisitor

Требования к платформе и версии: JVM (1.7), JRE7 (1.7)

@ExperimentalPathApi fun fileVisitor(
    builderAction: FileVisitorBuilder.() -> Unit
): FileVisitor<Path>

Создаёт FileVisitor, реализация которого определена в builderAction.

По умолчанию возвращаемый файловый посетитель посещает все файлы и повторно выбрасывает ошибки ввода-вывода, то есть:

• FileVisitor.preVisitDirectory возвращает FileVisitResult.CONTINUE.
• FileVisitor.visitFile возвращает FileVisitResult.CONTINUE.
• FileVisitor.visitFileFailed повторно выбрасывает исключение ввода-вывода, которое помешало посещению файла.
• FileVisitor.postVisitDirectory возвращает FileVisitResult.CONTINUE, если итерация каталога завершается без исключения ввода-вывода; в противном случае повторно выбрасывает исключение ввода-вывода, которое привело к преждевременному завершению итерации каталога.

Чтобы переопределить функцию, предоставьте её реализацию соответствующей функции FileVisitorBuilder, которая была передана в качестве получателя в builderAction. Обратите внимание, что каждая функция может быть переопределена только один раз. Повторное переопределение функции вызывает IllegalStateException.

Билдер действителен только внутри функции builderAction. Использование его вне функции вызывает IllegalStateException.

Пример:

val cleanVisitor = fileVisitor {
    onPreVisitDirectory { directory, _ ->
        if (directory.name == "build") {
            directory.toFile().deleteRecursively()
            FileVisitResult.SKIP_SUBTREE
        } else {
            FileVisitResult.CONTINUE
        }
    }

    onVisitFile { file, _ ->
        if (file.extension == "class") {
            file.deleteExisting()
        }
        FileVisitResult.CONTINUE
    }
}