Класс 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()

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