Класс Configuration

public Configuration resolve(ModuleFinder before, ModuleFinder after, Collection<String> roots)

Решает коллекцию корневых модулей с этим конфигурационным файлом в качестве родительского, чтобы создать новую конфигурацию. Этот метод работает точно так же, как и указано статическим методом resolve, когда вызывается с этим конфигурационным файлом в качестве родительского. Другими словами, если этот конфигурационный файл cf , то этот метод эквивалентен вызову:

 
     Configuration.resolve(before, List.of(cf), after, roots);
 

public Configuration resolveAndBind(ModuleFinder before, ModuleFinder after, Collection<String> roots)

Решает коллекцию корневых модулей с привязкой сервисов и с этим конфигурационным файлом в качестве родительского, чтобы создать новую конфигурацию. Этот метод работает точно так же, как и указано статическим методом resolveAndBind, когда вызывается с этим конфигурационным файлом в качестве родительского. Другими словами, если этот конфигурационный файл cf , то этот метод эквивалентен вызову:

 
     Configuration.resolveAndBind(before, List.of(cf), after, roots);
 

public static Configuration resolve(ModuleFinder before, List<Configuration> parents, ModuleFinder after, Collection<String> roots)

Решает коллекцию корневых модулей для создания конфигурации.

Каждый корневой модуль находится с помощью указанного before поиска модулей. Если модуль не найден, он находится в родительской конфигурации, как если бы вызывался метод findModule для каждого родителя в порядке итерации. Если не найден, модуль находится с помощью указанного after поиска модулей. Такой же порядок поиска используется для нахождения транзитивных зависимостей. Корневые модули или зависимости, которые находятся в родительской конфигурации, больше не решаются и не включаются в результирующую конфигурацию.

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

Решение может завершиться ошибкой FindException по следующим причинам, связанным с наблюдаемостью:

• Корневой модуль или прямая или транзитивная зависимость не найдены.

• При попытке найти модуль возникает ошибка. Возможные ошибки включают ошибки ввода-вывода, ошибки, обнаруженные при разборе описания модуля (module-info.class) или обнаружение двух версий одного и того же модуля в одном каталоге.

Решение может завершиться ошибкой ResolutionException в случае возникновения любой из следующих проверок согласованности:

• Обнаружена циклическая зависимость, например, когда модуль m1 требует модуля m2 и m2 требует m1.

• Модуль читает два или более модулей с одинаковым именем. Это включает случай, когда модуль читает другой с тем же именем, что и сам.

• Два или более модуля в конфигурации экспортируют один и тот же пакет в модуль, который читает оба. Это включает случай, когда модуль M с пакетом p читает другой модуль, который экспортирует p в M.

• Модуль M объявляет, что он "uses p.S" или "provides p.S with ...", но пакет p не входит в модуль M и не экспортируется в M ни одним модулем, который M читает.

public static Configuration resolveAndBind(ModuleFinder before, List<Configuration> parents, ModuleFinder after, Collection<String> roots)

Решает коллекцию корневых модулей с привязкой сервисов для создания конфигурации.

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

Более конкретно, корневые модули решаются так же, как если бы вызывался метод resolve. Затем решённые модули и все модули в родительских конфигурациях с service dependences проверяются. Все модули, найденные указанными поисками модулей, которые provide реализацию одного или нескольких типов сервисов, добавляются в граф модулей, а затем решаются как если бы вызывался метод resolve. Добавление модулей в граф модулей может вводить новые зависимости использования сервисов, поэтому процесс работает итеративно, пока больше модулей не будет добавлено.

Так как привязка сервисов включает решение, она может завершиться ошибкой FindException или ResolutionException по тем же причинам, которые указаны в resolve.

public static Configuration empty()

Возвращает пустую конфигурацию. В пустой конфигурации нет модулей. У неё нет родителей.

public List<Configuration> parents()

Возвращает список родителей этой конфигурации, неизменяемый, в порядке поиска. Если это пустая конфигурация, то возвращается пустой список.

public Set<ResolvedModule> modules()

Возвращает неизменяемый набор решённых модулей в этой конфигурации.

public Optional<ResolvedModule> findModule(String name)

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

public String toString()

Возвращает строку, описывающую эту конфигурацию.