Интерфейс ModuleFinder

public interface ModuleFinder

Поисковик модулей. ModuleFinder используется для поиска модулей во время разрешения или связывания сервисов.

ModuleFinder может найти только один модуль с заданным именем. ModuleFinder, который ищет модули в последовательности каталогов, например, найдёт первое вхождение модуля с заданным именем и проигнорирует другие модули с таким же именем, которые встречаются в более поздних каталогах последовательности.

Пример использования:

Path dir1, dir2, dir3;

     ModuleFinder finder = ModuleFinder.of(dir1, dir2, dir3);

     Optional<ModuleReference> omref = finder.find("jdk.foo");
     omref.ifPresent(mref -> ... );

Методы find и findAll, определённые здесь, могут завершиться ошибкой по нескольким причинам. К ним относятся ошибки ввода-вывода, ошибки, обнаруженные при разборе описания модуля (module-info.class), или, в случае ModuleFinder возвращённого ModuleFinder.of, обнаружение двух или более модулей с одинаковым именем в одном каталоге. При обнаружении ошибки эти методы выбрасывают исключение FindException с соответствующим cause. Поведение ModuleFinder после выбрасывания FindException не определено. Например, вызов find после выбрасывания исключения может или не может сканировать те же самые модули, которые привели к возникновению исключения. Рекомендуется удалять поисковик модулей после того, как будет выбрашено исключение.

ModuleFinder не обязан быть потокобезопасным.