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

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