Класс URLClassLoader

public URLClassLoader(URL[] urls, ClassLoader parent)

Создаёт новый URLClassLoader для указанных URL-адресов. URL-адреса будут просматриваться в заданном порядке для поиска классов и ресурсов после предварительного поиска в указанном родительском загрузчике классов. Любой URL-адрес со схемой jar: предполагается, что он ссылается на JAR-файл. Любой URL-адрес со схемой file:, заканчивающийся на '/', предполагается, что он ссылается на директорию. В противном случае URL-адрес предполагается, что он ссылается на JAR-файл, который будет загружен и открыт по мере необходимости.

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

public URLClassLoader(URL[] urls)

Создаёт новый URLClassLoader для указанных URL-адресов, используя родительский загрузчик по умолчанию. URL-адреса будут просматриваться в заданном порядке для поиска классов и ресурсов после предварительного поиска в родительском загрузчике классов. Любой URL-адрес, заканчивающийся на '/', предполагается, что он ссылается на директорию. В противном случае URL-адрес предполагается, что он ссылается на JAR-файл, который будет загружен и открыт по мере необходимости.

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

public URLClassLoader(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)

Создаёт новый URLClassLoader для указанных URL-адресов, родительского загрузчика классов и URLStreamHandlerFactory. Аргумент parent будет использоваться в качестве родительского загрузчика классов для делегирования. Аргумент factory будет использоваться в качестве загрузчика обработчика потоков для получения обработчиков протоколов при создании новых URL-адресов JAR.

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

public URLClassLoader(String name, URL[] urls, ClassLoader parent)

Создаёт новый именованный URLClassLoader для указанных URL-адресов. URL-адреса будут просматриваться в заданном порядке для поиска классов и ресурсов после предварительного поиска в указанном родительском загрузчике классов. Любой URL-адрес, заканчивающийся на '/', предполагается, что он ссылается на директорию. В противном случае URL-адрес предполагается, что он ссылается на JAR-файл, который будет загружен и открыт по мере необходимости.

public URLClassLoader(String name, URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)

Создаёт новый именованный URLClassLoader для указанных URL-адресов, родительского загрузчика классов и URLStreamHandlerFactory. Аргумент parent будет использован в качестве родительского загрузчика классов для делегирования. Аргумент factory будет использован в качестве загрузчика обработчика потоков для получения обработчиков протоколов при создании новых URL-адресов JAR.

public InputStream getResourceAsStream(String name)

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

Порядок поиска описан в документации для ClassLoader.getResource(String).

public void close() throws IOException

Закрывает этот URLClassLoader, чтобы он больше не мог использоваться для загрузки новых классов или ресурсов, определённых этим загрузчиком. Классы и ресурсы, определённые любыми родителями этого загрузчика в иерархии делегирования, всё ещё доступны. Также любые классы или ресурсы, которые уже загружены, остаются доступными.

В случае с URL-адресами jar: и file:, он также закрывает любые файлы, которые были открыты им. Если другой поток загружает класс во время вызова метода close, результат этой загрузки неопределён.

Метод прилагает все усилия для закрытия всех открытых файлов, перехватывая IOException внутри. Необработанные исключения и ошибки не перехватываются. Вызов close для уже закрытого загрузчика не имеет эффекта.

protected void addURL(URL url)

Добавляет указанный URL-адрес в список URL-адресов для поиска классов и ресурсов.

Если указанный URL-адрес null или уже находится в списке URL-адресов, или если этот загрузчик закрыт, вызов этого метода не имеет эффекта.

public URL[] getURLs()

Возвращает путь поиска URL-адресов для загрузки классов и ресурсов. Это включает исходный список URL-адресов, указанных в конструкторе, а также любые URL-адреса, добавленные позже методом addURL().

protected Class<?> findClass(String name) throws ClassNotFoundException

Находит и загружает класс с указанным именем из пути поиска URL. Любые URL, которые ссылаются на JAR-файлы, загружаются и открываются по мере необходимости, пока класс не будет найден.

protected Package definePackage(String name, Manifest man, URL url)

Определяет новый пакет по имени в этом URLClassLoader. Атрибуты, содержащиеся в указанном Manifest, будут использованы для получения информации о версии пакета и его герметизации. Для герметичных пакетов дополнительный URL указывает URL-адрес исходного кода, из которого был загружен пакет.

public URL findResource(String name)

Находит ресурс с указанным именем в пути поиска URL.

public Enumeration<URL> findResources(String name) throws IOException

Возвращает перечисление URL-адресов, представляющих все ресурсы в пути поиска URL, имеющие указанное имя.

protected PermissionCollection getPermissions(CodeSource codesource)

Возвращает разрешения для данного объекта codesource. Реализация этого метода сначала вызывает super.getPermissions, а затем добавляет разрешения на основе URL-адреса codesource.

Если протокол этого URL-адреса равен "jar", то предоставленное разрешение основано на разрешении, необходимом для URL-адреса JAR-файла.

Если протокол равен "file" и есть компонент authority, то может быть предоставлено разрешение на подключение к этому узлу и принятие подключений от него. Если протокол равен "file" и путь указывает на файл, то предоставляется разрешение на чтение этого файла. Если протокол равен "file" и путь указывает на каталог, то предоставляется разрешение на чтение всех файлов и (рекурсивно) всех файлов и подкаталогов, содержащихся в этом каталоге.

Если протокол не равен "file", то предоставляется разрешение на подключение к узлу URL и принятие подключений от него.

public static URLClassLoader newInstance(URL[] urls, ClassLoader parent)

Создает новый экземпляр URLClassLoader для указанных URL-адресов и родительского загрузчика классов. Если установлена система безопасности, метод loadClass возвращаемого URLClassLoader этим методом вызовет метод SecurityManager.checkPackageAccess перед загрузкой класса.

public static URLClassLoader newInstance(URL[] urls)

Создает новый экземпляр URLClassLoader для указанных URL-адресов и по умолчанию родительского загрузчика классов. Если установлена система безопасности, метод loadClass возвращаемого URLClassLoader этим методом вызовет метод SecurityManager.checkPackageAccess перед загрузкой класса.