Класс ModuleLayer

public ModuleLayer defineModulesWithOneLoader(Configuration cf, ClassLoader parentLoader)

Создаёт новый слой модулей, с этим слоем в качестве родительского, определяя модули в заданной Configuration для виртуальной машины Java. Данный метод создаёт один загрузчик классов и определяет все модули для этого загрузчика. parent каждого загрузчика классов является заданным родительским загрузчиком. Данный метод работает точно так же, как и указано в статическом методе defineModulesWithOneLoader, когда вызывается с этим слоем в качестве родительского. Другими словами, если этот слой thisLayer , то этот метод эквивалентен вызову:

 
     ModuleLayer.defineModulesWithOneLoader(cf, List.of(thisLayer), parentLoader).layer();
 

public ModuleLayer defineModulesWithManyLoaders(Configuration cf, ClassLoader parentLoader)

Создаёт новый слой модулей, с этим слоем в качестве родительского, определяя модули в заданной Configuration для виртуальной машины Java. Каждый модуль определяется для собственного ClassLoader, созданного этим методом. parent каждого загрузчика классов является заданным родительским загрузчиком. Данный метод работает точно так же, как и указано в статическом методе defineModulesWithManyLoaders, когда вызывается с этим слоем в качестве родительского. Другими словами, если этот слой thisLayer , то этот метод эквивалентен вызову:

 
     ModuleLayer.defineModulesWithManyLoaders(cf, List.of(thisLayer), parentLoader).layer();
 

public ModuleLayer defineModules(Configuration cf, Function<String,ClassLoader> clf)

Создаёт новый слой модулей, с этим слоем в качестве родительского, определяя модули в заданной Configuration для виртуальной машины Java. Каждый модуль отображается по имени на его загрузчик классов с помощью заданной функции. Данный метод работает точно так же, как и указано в статическом методе defineModules, когда вызывается с этим слоем в качестве родительского. Другими словами, если этот слой thisLayer , то этот метод эквивалентен вызову:

 
     ModuleLayer.defineModules(cf, List.of(thisLayer), clf).layer();
 

public static ModuleLayer.Controller defineModulesWithOneLoader(Configuration cf, List<ModuleLayer> parentLayers, ClassLoader parentLoader)

Создаёт новый слой модулей, определяя модули в заданной Configuration для виртуальной машины Java. Данный метод создаёт один загрузчик классов и определяет все модули для этого загрузчика.

Загрузчик классов, созданный этим методом, реализует прямую делегацию при загрузке классов из модулей. Если метод loadClass вызывается для загрузки класса, то он использует имя пакета класса для его сопоставления с модулем. Это может быть модуль в этом слое и, следовательно, определён для того же загрузчика классов. Это может быть пакет в модуле в родительском слое, который экспортирован в один или несколько модулей в этом слое. Загрузчик делегирует загрузчику класса модуля, выбросив ClassNotFoundException если не найден этим загрузчиком. Когда loadClass вызывается для загрузки классов, которые не сопоставляются с модулем, то он делегирует родительскому загрузчику классов.

Загрузчик классов, созданный этим методом, находит ресурсы (getResource, getResources и другие методы ресурсов) во всех модулях в слое перед поиском в родительском загрузчике классов.

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

• Перекрывающиеся пакеты: Два или более модулей в конфигурации имеют одинаковый пакет.

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

Кроме того, слой не может быть создан, если конфигурация содержит модуль с именем "java.base", или модуль содержит пакет с именем "java" или пакет с именем, начинающимся с "java.".

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

public static ModuleLayer.Controller defineModulesWithManyLoaders(Configuration cf, List<ModuleLayer> parentLayers, ClassLoader parentLoader)

Создаёт новый слой модулей, определяя модули в заданной Configuration для виртуальной машины Java. Каждый модуль определяется со своим собственным ClassLoader, созданным этим методом. Родительским parent каждого загрузчика классов является заданный родительский загрузчик классов.

Загрузчики классов, созданные этим методом, реализуют прямую делегацию при загрузке классов из модулей. Если вызывается метод loadClass для загрузки класса, то он использует имя пакета класса для его сопоставления с модулем. Пакет может находиться в модуле, определённом для загрузчика классов. Пакет может быть экспортирован другим модулем в этом слое для модуля, определённого для загрузчика классов. Он также может находиться в пакете, экспортированном модулем в родительском слое. Загрузчик классов делегирует загрузчику класса модуля, генерируя ClassNotFoundException если он не найден этим загрузчиком. Когда вызывается loadClass для загрузки класса, который не сопоставляется с модулем, то делегирование происходит родительскому загрузчику классов.

Загрузчики классов, созданные этим методом, ищут ресурсы (getResource, getResources и другие методы ресурсов) в модуле, определённом для загрузчика классов, прежде чем искать их в родительском загрузчике классов.

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

public static ModuleLayer.Controller defineModules(Configuration cf, List<ModuleLayer> parentLayers, Function<String,ClassLoader> clf)

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

Делегирование загрузчика классов, реализованное загрузчиками классов, должно учитывать читаемость модулей. Загрузчики классов должны быть parallel-capable, чтобы избежать тупиков при загрузке классов. Кроме того, сущность, создающая новый слой с помощью этого метода, должна обеспечить готовность загрузчиков классов к загрузке из этих модулей до любых попыток загрузки классов или ресурсов.

Создание слоя может завершиться неудачей по следующим причинам:

• Два или более модуля с одинаковым пакетом сопоставлены с одним загрузчиком классов.

• Модуль сопоставлен с загрузчиком классов, которому уже определён модуль с тем же именем.

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

Кроме того, слой не может быть создан, если конфигурация содержит модуль с именем "java.base", конфигурация содержит модуль с пакетом, названным "java", или имя пакета, начинающееся с "java.", или функция для сопоставления имени модуля с загрузчиком классов возвращает null или платформенный загрузчик классов.

Если функция сопоставления имени модуля с загрузчиком классов выбрасывает ошибку или исключение выполнения, то оно передаётся вызывающему методу.

public Configuration configuration()

Возвращает конфигурацию для этого слоя.

public List<ModuleLayer> parents()

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

public Set<Module> modules()

Возвращает неизменяемый набор модулей в этом слое.

public Optional<Module> findModule(String name)

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

public ClassLoader findLoader(String name)

Возвращает загрузчик ClassLoader для модуля с заданным именем. Если модуль с заданным именем не в этом слое, то ищутся родительские parent слои способом, указанным в findModule.

Если установлен менеджер безопасности, то вызывается его метод checkPermission с разрешением RuntimePermission("getClassLoader") для проверки возможности доступа вызывающего к загрузчику классов.

public String toString()

Возвращает строку, описывающую этот слой модулей.

public static ModuleLayer empty()

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

public static ModuleLayer boot()

Возвращает слой загрузки. Слой загрузки содержит по крайней мере один модуль, java.base. Его родителем является empty слой.