Класс ModuleLayer

public final class ModuleLayer
extends Object

Слой модулей в виртуальной машине Java.

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

Создание слоя создает объект Module для каждого ResolvedModule в конфигурации. Для каждого разрешенного модуля, который read, Module reads соответствующий исполняемый Module, который может находиться в том же слое или в parent слое.

Методы defineModulesWithOneLoader и defineModulesWithManyLoaders предоставляют удобные способы создания слоя модулей, где все модули сопоставляются с одним загрузчиком классов или где каждый модуль сопоставляется со своим собственным загрузчиком классов. Метод defineModules предназначен для более сложных случаев, когда модули сопоставляются с пользовательскими загрузчиками классов с помощью функции, указанной в методе. Каждый из этих методов имеет инстанс- и статический варианты. Методы-инстансы создают слой с получателем в качестве родительского слоя. Статические методы предназначены для более сложных случаев, когда может быть более одного родительского слоя или когда требуется Controller для управления модулями в слое

У виртуальной машины Java есть по крайней мере один непустой слой, boot слой, который создается при запуске виртуальной машины Java. Слой загрузки содержит модуль java.base и является единственным слоем в виртуальной машине Java с модулем, названным "java.base". Модули в слое загрузки сопоставляются с загрузчиком bootstrap-классов и другими загрузчиками классов, которые являются встроенными в виртуальную машину Java. Слой загрузки часто будет parent при создании дополнительных слоев.

Каждый Module в слое создается так, чтобы он exports и opens пакеты, описанные его ModuleDescriptor. Квалифицированные экспорты (где пакет экспортируется в набор целевых модулей, а не во все модули) реализуются при создании слоя следующим образом:

• Если модуль X экспортирует пакет в Y, и если исполняемый Module X считывает Module Y, то пакет экспортируется в Module Y (который может находиться в том же слое, что и X или в родительском слое).
• Если модуль X экспортирует пакет в Y, и если исполняемый Module X не считывает Y, то целевой Y ищется так, как если бы вы вызывали findModule для поиска модуля в слое или его родительских слоях. Если Y найден, то пакет экспортируется в экземпляр Y , который был найден. Если Y не найден, то квалифицированный экспорт игнорируется.

Квалифицированные открытия обрабатываются так же, как и квалифицированные экспорты.

Как и при создании Configuration, automatic модули получают специальное обращение при создании слоя. Автоматический модуль создается в виртуальной машине Java как Module , который считывает все безымянные Module в виртуальной машине Java.

Если не указано иное, передача null аргумента в метод в этом классе вызывает исключение NullPointerException.

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

В этом примере создается конфигурация путем разрешения модуля, названного "myapp", с конфигурацией для слоя загрузки в качестве родительского элемента. Затем создается новый слой с модулями в этой конфигурации. Все модули определены для одного и того же загрузчика классов.

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

     ModuleLayer parent = ModuleLayer.boot();

     Configuration cf = parent.configuration().resolve(finder, ModuleFinder.of(), Set.of("myapp"));

     ClassLoader scl = ClassLoader.getSystemClassLoader();

     ModuleLayer layer = parent.defineModulesWithOneLoader(cf, scl);

     Class<?> c = layer.findLoader("myapp").loadClass("app.Main");