compact1, compact2, compact3

java.net

Класс URLClassLoader

java.lang. Объект

java.lang. ClassLoder

java.security. SecureClassLoader

java.net. URLClassLoader

Все Реализованные Интерфейсы:

Closeable, AutoCloseable

Прямые Известные Подклассы:

MLet

public class URLClassLoader
extends SecureClassLoader
implements Closeable

Этот загрузчик class используется, чтобы загрузить классы и ресурсы от пути поиска URL, обращающихся к файлам JAR и к каталогам. Любой URL, который заканчивается '/', как предполагается, ссылается на каталог. Иначе, URL, как предполагается, обращается к файлу JAR, который будет открыт как необходимый.

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

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

Где файл JAR содержит Profile атрибут тогда его значение является именем Java профиль SE, которого минимально требует библиотека. Если это время выполнения не поддерживает профиль тогда, это вызывает UnsupportedProfileException быть брошенным в некоторое нетребуемое время.

С тех пор:

1.2

Сводка конструктора

Конструкторы

Конструктор и Описание
URLClassLoader(URL[] urls) Создает новый URLClassLoader для указанных URL, используя родителя делегации значения по умолчанию ClassLoader.
URLClassLoader(URL[] urls, ClassLoader parent) Создает новый URLClassLoader для данных URL.
URLClassLoader(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory) Создает новый URLClassLoader для указанных URL, родительского загрузчика class, и URLStreamHandlerFactory.

Сводка метода

Модификатор и Тип	Метод и Описание
protected void	addURL(URL url) Добавляет указанный URL к списку URL, чтобы искать классы и ресурсы.
void	close() Завершения этот URLClassLoader, так, чтобы это больше не могло использоваться, чтобы загрузить новые классы или ресурсы, которые определяются этим загрузчиком.
protected Package	definePackage(String name, Manifest man, URL url) Определяет новый пакет по имени в этом ClassLoder.
protected Class<?>	findClass(String name) Находит и загружает class указанным именем от пути поиска URL.
URL	findResource(String name) Находит ресурс с указанным именем на пути поиска URL.
Enumeration<URL>	findResources(String name) Возвращает Перечисление URL, представляющих все ресурсы на пути поиска URL, имеющем указанное имя.
protected PermissionCollection	getPermissions(CodeSource codesource) Возвращает полномочия для данного объекта codesource.
InputStream	getResourceAsStream(String name) Возвращает входной поток для того, чтобы считать указанный ресурс.
URL[]	getURLs() Возвращает путь поиска URL для того, чтобы загрузить классы и ресурсы.
static URLClassLoader	newInstance(URL[] urls) Создает новый экземпляр URLClassLoader для указанных URL, и значение по умолчанию порождают загрузчик class.
static URLClassLoader	newInstance(URL[] urls, ClassLoader parent) Создает новый экземпляр URLClassLoader для указанных URL и родительского загрузчика class.

Методы, наследованные от class java.security. SecureClassLoader

defineClass, defineClass

Методы, наследованные от class java.lang. ClassLoder

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Методы, наследованные от class java.lang. Объект

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Деталь конструктора

URLClassLoader

public URLClassLoader(URL[] urls,
                      ClassLoader parent)

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

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

Параметры:

urls - URL, из которых можно загрузить классы и ресурсы

parent - родительский загрузчик class для делегации

Броски:

SecurityException - если менеджер безопасности существует и checkCreateClassLoader метод не позволяет создание загрузчика class.

См. Также:

SecurityManager.checkCreateClassLoader()

URLClassLoader

public URLClassLoader(URL[] urls)

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

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

Параметры:

urls - URL, из которых можно загрузить классы и ресурсы

Броски:

SecurityException - если менеджер безопасности существует и checkCreateClassLoader метод не позволяет создание загрузчика class.

См. Также:

SecurityManager.checkCreateClassLoader()

URLClassLoader

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

Создает новый URLClassLoader для указанных URL, родительского загрузчика class, и URLStreamHandlerFactory. Родительский параметр будет использоваться в качестве родительского загрузчика class для делегации. Параметр фабрики будет использоваться в качестве потоковой фабрики обработчиков, чтобы получить обработчики протокола, создавая новую флягу URL.

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

Параметры:

urls - URL, из которых можно загрузить классы и ресурсы

parent - родительский загрузчик class для делегации

factory - URLStreamHandlerFactory, чтобы использовать, создавая URL

Броски:

SecurityException - если менеджер безопасности существует и checkCreateClassLoader метод не позволяет создание загрузчика class.

См. Также:

SecurityManager.checkCreateClassLoader()

Деталь метода

getResourceAsStream

public InputStream getResourceAsStream(String name)

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

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

Переопределения:

getResourceAsStream в class ClassLoader

Параметры:

name - Имя ресурса

Возвраты:

Входной поток для того, чтобы считать ресурс, или null, если ресурс не мог бы быть найден

С тех пор:

1.7

близко

public void close()
           throws IOException

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

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

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

Определенный:

close в интерфейсе Closeable

Определенный:

close в интерфейсе AutoCloseable

Броски:

IOException - если закрытие любого файла, открытого этим загрузчиком class, привело к IOException. Любые такие исключения пойманы внутренне. Если только один пойман, то это повторно бросается. Если больше чем одно исключение поймано, то вторые и после исключений добавляются как заблокированные исключительные ситуации первого пойманного, который тогда повторно бросается.

SecurityException - если менеджер безопасности устанавливается, и он отрицает RuntimePermission("closeClassLoader")

С тех пор:

1.7

addURL

protected void addURL(URL url)

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

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

Параметры:

url - URL, который будет добавлен к пути поиска URL

getURLs

public URL[] getURLs()

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

Возвраты:

путь поиска URL для того, чтобы загрузить классы и ресурсы.

findClass

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

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

Переопределения:

findClass в class ClassLoader

Параметры:

name - имя class

Возвраты:

получающийся class

Броски:

ClassNotFoundException - если class не мог бы быть найден, или если загрузчик закрывается.

definePackage

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

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

Параметры:

name - имя пакета

man - Декларация, содержащая версию пакета и изолирующая информацию

url - исходный url кода для пакета, или нуль, если ни один

Возвраты:

недавно определенный объект Пакета

Броски:

IllegalArgumentException - если имя пакета копирует существующий пакет или в этом загрузчике class или в одном из его предков

findResource

public URL findResource(String name)

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

Переопределения:

findResource в class ClassLoader

Параметры:

name - имя ресурса

Возвраты:

a URL для ресурса, или null если ресурс не мог бы быть найден, или если загрузчик закрывается.

findResources

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

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

Переопределения:

findResources в class ClassLoader

Параметры:

name - имя ресурса

Возвраты:

Enumeration из URLs, Если загрузчик закрывается, Перечисление будет пусто.

Броски:

IOException - если исключение ввода-вывода происходит

getPermissions

protected PermissionCollection getPermissions(CodeSource codesource)

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

Если протокол этого URL является "флягой", то предоставленное разрешение основано на разрешении, которое требуется URL файла Фляги.

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

Если протокол не является "файлом", то разрешение, чтобы соединиться с и принять соединения от узла URL предоставляют.

Переопределения:

getPermissions в class SecureClassLoader

Параметры:

codesource - codesource

Возвраты:

полномочия, предоставленные codesource

newInstance

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

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

Параметры:

urls - URL, чтобы искать классы и ресурсы

parent - родительский загрузчик class для делегации

Возвраты:

получающийся загрузчик class

newInstance

public static URLClassLoader newInstance(URL[] urls)

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

Параметры:

urls - URL, чтобы искать классы и ресурсы

Возвраты:

получающийся загрузчик class