URLClassLoader (Платформа Java SE 7)

java.lang. Объект
- java.lang. ClassLoder
- - java.security. SecureClassLoader
  - - java.net. URLClassLoader

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

Closeable, AutoCloseable

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

MLet
```
public class URLClassLoader
extends SecureClassLoader
implements Closeable
```
Этот загрузчик класса используется, чтобы загрузить классы и ресурсы от пути поиска URL, обращающихся к файлам JAR и к каталогам. Любой URL, который заканчивается '/', как предполагается, ссылается на каталог. Иначе, URL, как предполагается, обращается к файлу JAR, который будет открыт как необходимый.
AccessControlContext потока, который создал экземпляр URLClassLoader, будет использоваться, впоследствии загружая классы и ресурсы.
Классы, которые загружаются, значением по умолчанию, предоставленным разрешение только, чтобы получить доступ к URL, определенным, когда URLClassLoader создавался.

С тех пор:

1.2

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

Конструкторы
Конструктор и Описание
`URLClassLoader(URL[] urls)` Создает новый URLClassLoader для указанных URL, используя родителя делегации по умолчанию `ClassLoader`.
`URLClassLoader(URL[] urls, ClassLoader parent)` Создает новый URLClassLoader для данных URL.
`URLClassLoader(URL[] urls, ClassLoader parent, URLStreamHandlerFactory factory)` Создает новый URLClassLoader для указанных URL, загрузчика родительского класса, и 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)` Находит и загружает класс указанным именем от пути поиска 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 и загрузчика родительского класса по умолчанию.
`static URLClassLoader`	`newInstance(URL[] urls, ClassLoader parent)` Создает новый экземпляр URLClassLoader для указанных URL и загрузчика родительского класса.

Методы java.security унаследованный от класса. SecureClassLoader
defineClass, defineClass

Методы 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

Методы java.lang унаследованный от класса. Объект
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Деталь конструктора
  - URLClassLoader
```
public URLClassLoader(URL[] urls,
              ClassLoader parent)
```
    Создает новый URLClassLoader для данных URL. URL будут искаться в порядке, определенном для классов и ресурсов после первого поиска в указанном загрузчике родительского класса. Любой URL, который заканчивается '/', как предполагается, ссылается на каталог. Иначе, URL, как предполагается, обращается к файлу JAR, который будет загружен и открыт как необходимый.
    Если есть менеджер безопасности, этот метод первые вызовы менеджер безопасности checkCreateClassLoader метод, чтобы гарантировать создание загрузчика класса позволяется.
    
    Параметры:
    urls - URL, из которых можно загрузить классы и ресурсы
    parent - загрузчик родительского класса для делегации
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и checkCreateClassLoader метод не позволяет создание загрузчика класса.
    См. Также:
    SecurityManager.checkCreateClassLoader()
  - URLClassLoader
```
public URLClassLoader(URL[] urls)
```
    Создает новый URLClassLoader для указанных URL, используя родителя делегации по умолчанию ClassLoader. URL будут искаться в порядке, определенном для классов и ресурсов после первого поиска в загрузчике родительского класса. Любой URL, который заканчивается '/', как предполагается, ссылается на каталог. Иначе, URL, как предполагается, обращается к файлу JAR, который будет загружен и открыт как необходимый.
    Если есть менеджер безопасности, этот метод первые вызовы менеджер безопасности checkCreateClassLoader метод, чтобы гарантировать создание загрузчика класса позволяется.
    
    Параметры:
    urls - URL, из которых можно загрузить классы и ресурсы
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и checkCreateClassLoader метод не позволяет создание загрузчика класса.
    См. Также:
    SecurityManager.checkCreateClassLoader()
  - URLClassLoader
```
public URLClassLoader(URL[] urls,
              ClassLoader parent,
              URLStreamHandlerFactory factory)
```
    Создает новый URLClassLoader для указанных URL, загрузчика родительского класса, и URLStreamHandlerFactory. Родительский параметр будет использоваться в качестве загрузчика родительского класса для делегации. Параметр фабрики будет использоваться в качестве потоковой фабрики обработчиков, чтобы получить обработчики протокола, создавая новую флягу URL.
    Если есть менеджер безопасности, этот метод первые вызовы менеджер безопасности checkCreateClassLoader метод, чтобы гарантировать создание загрузчика класса позволяется.
    
    Параметры:
    urls - URL, из которых можно загрузить классы и ресурсы
    parent - загрузчик родительского класса для делегации
    factory - URLStreamHandlerFactory, чтобы использовать, создавая URL
    
    Броски:
    
    SecurityException - если менеджер безопасности существует и checkCreateClassLoader метод не позволяет создание загрузчика класса.
    См. Также:
    SecurityManager.checkCreateClassLoader()
- Деталь метода
  - getResourceAsStream
```
public InputStream getResourceAsStream(String name)
```
    Возвращает входной поток для того, чтобы считать указанный ресурс. Если этот загрузчик будет закрыт, то любые ресурсы, открытые этим методом, будут закрыты.
    Поисковый порядок описывается в документации для ClassLoader.getResource(String).
    
    Переопределения:
    
    getResourceAsStream в классе ClassLoader
    
    Параметры:
    name - Имя ресурса
    
    Возвраты:
    Входной поток для того, чтобы считать ресурс, или null, если ресурс не мог бы быть найден
    С тех пор:
    
    1.7
  - близко
```
public void close()
           throws IOException
```
    Завершения этот URLClassLoader, так, чтобы это больше не могло использоваться, чтобы загрузить новые классы или ресурсы, которые определяются этим загрузчиком. Классы и ресурсы, определенные любым из родителей этого загрузчика в иерархии делегации, все еще доступны. Кроме того, любые классы или ресурсы, которые уже загружаются, все еще доступны.
    В случае фляги: и файл: URL, это также закрывает любые файлы, которые были открыты этим. Если другой поток загружает класс когда close метод вызывается, тогда результат той загрузки неопределен.
    Метод предпринимает попытку максимальных усилий закрыть все открытые файлы, ловя IOExceptions внутренне. Исключения непроверенные и ошибки не пойманы. Вызов близко на уже закрытом загрузчике не имеет никакого эффекта.
    
    Определенный:
    
    close в интерфейсе Closeable
    
    Определенный:
    
    close в интерфейсе AutoCloseable
    
    Броски:
    
    IOException - если закрытие любого файла, открытого этим загрузчиком класса, привело к 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
```
    Находит и загружает класс указанным именем от пути поиска URL. Любые URL, обращающиеся к файлам JAR, загружаются и открываются как необходимый, пока класс не находится.
    
    Переопределения:
    
    findClass в классе ClassLoader
    
    Параметры:
    name - имя класса
    
    Возвраты:
    получающийся класс
    
    Броски:
    
    ClassNotFoundException - если класс не мог бы быть найден, или если загрузчик закрывается.
  - definePackage
```
protected Package definePackage(String name,
                    Manifest man,
                    URL url)
                         throws IllegalArgumentException
```
    Определяет новый пакет по имени в этом ClassLoder. Атрибуты, содержавшиеся в указанной Декларации, будут использоваться, чтобы получить версию пакета и информацию об изоляции. Для изолированных пакетов дополнительный URL определяет источник кода URL, из которого был загружен пакет.
    
    Параметры:
    name - имя пакета
    man - Декларация, содержащая версию пакета и изолирующая информацию
    url - исходный url кода для пакета, или нуль, если ни один
    
    Возвраты:
    недавно определенный объект Пакета
    
    Броски:
    
    IllegalArgumentException - если имя пакета копирует существующий пакет или в этом загрузчике класса или в одном из его предков
  - findResource
```
public URL findResource(String name)
```
    Находит ресурс с указанным именем на пути поиска URL.
    
    Переопределения:
    
    findResource в классе ClassLoader
    
    Параметры:
    name - имя ресурса
    
    Возвраты:
    a URL для ресурса, или null если ресурс не мог бы быть найден, или если загрузчик закрывается.
  - findResources
```
public Enumeration<URL> findResources(String name)
                               throws IOException
```
    Возвращает Перечисление URL, представляющих все ресурсы на пути поиска URL, имеющем указанное имя.
    
    Переопределения:
    
    findResources в классе ClassLoader
    
    Параметры:
    name - имя ресурса
    
    Возвраты:
    Enumeration из URLs, Если загрузчик закрывается, Перечисление будет пусто.
    
    Броски:
    
    IOException - если исключение ввода-вывода происходит
  - getPermissions
```
protected PermissionCollection getPermissions(CodeSource codesource)
```
    Возвращает полномочия для данного объекта codesource. Реализация этого метода сначала вызывает super.getPermissions и затем добавляет полномочия, основанные на URL codesource.
    Если протокол этого URL является "флягой", то предоставленное разрешение основано на разрешении, которое требуется URL файла Фляги.
    Если протокол является "файлом" и есть компонент полномочий, то разрешение, чтобы соединиться с и принять соединения от тех полномочий можно предоставить. Если протокол является "файлом", и путь определяет файл, то разрешение, чтобы считать тот файл предоставляют. Если протокол является "файлом", и путь является каталогом, разрешение предоставляют считать все файлы и (рекурсивно) все файлы и подкаталоги, содержавшиеся в том каталоге.
    Если протокол не является "файлом", то разрешение, чтобы соединиться с и принять соединения от узла URL предоставляют.
    
    Переопределения:
    
    getPermissions в классе SecureClassLoader
    
    Параметры:
    codesource - codesource
    
    Возвраты:
    полномочия, предоставленные codesource
  - newInstance
```
public static URLClassLoader newInstance(URL[] urls,
                         ClassLoader parent)
```
    Создает новый экземпляр URLClassLoader для указанных URL и загрузчика родительского класса. Если менеджер безопасности устанавливается, loadClass метод URLClassLoader, возвращенного этим методом, вызовет SecurityManager.checkPackageAccess метод прежде, чем загрузить класс.
    
    Параметры:
    urls - URL, чтобы искать классы и ресурсы
    parent - загрузчик родительского класса для делегации
    
    Возвраты:
    получающийся загрузчик класса
  - newInstance
```
public static URLClassLoader newInstance(URL[] urls)
```
    Создает новый экземпляр URLClassLoader для указанных URL и загрузчика родительского класса по умолчанию. Если менеджер безопасности устанавливается, loadClass метод URLClassLoader, возвращенного этим методом, вызовет SecurityManager.checkPackageAccess прежде, чем загрузить класс.
    
    Параметры:
    urls - URL, чтобы искать классы и ресурсы
    
    Возвраты:
    получающийся загрузчик класса

Представьте ошибку или функцию
Для дальнейшей ссылки API и документации разработчика, см. Java Документация SE. Та документация содержит более подробные, предназначенные разработчиком описания, с концептуальными краткими обзорами, определениями сроков, обходных решений, и рабочих примеров кода.
Авторское право © 1993, 2011, Oracle и/или его филиалы. Все права защищены.

Класс URLClassLoader

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

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

Методы java.security унаследованный от класса. SecureClassLoader

Методы java.lang унаследованный от класса. ClassLoder

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

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

URLClassLoader

URLClassLoader

URLClassLoader

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

getResourceAsStream

близко

addURL

getURLs

findClass

definePackage

findResource

findResources

getPermissions

newInstance

newInstance