Класс ClassLoader

protected ClassLoader(String name, ClassLoader parent)

Примечание API:

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

Параметры:

name - имя загрузчика классов; или null, если имя не указано

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

Исключения:

IllegalArgumentException - если заданное имя пустое.

С:

9

protected ClassLoader(ClassLoader parent)

Примечание API:

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

Параметры:

parent - Родительский загрузчик классов

С:

1.2

protected ClassLoader()

public String getName()

Примечание API:

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

Возвращает:

Имя этого загрузчика классов; или null, если этот загрузчик классов не имеет имени.

С:

9

public Class<?> loadClass(String name) throws ClassNotFoundException

Параметры:

name - Бинарное имя класса

Возвращает:

Результат — объект Class

Исключения:

ClassNotFoundException - Если класс не был найден

protected Class<?> loadClass(String name, boolean resolve) throws ClassNotFoundException

Параметры:

name - Бинарное имя класса

resolve - Если true, разрешить класс

Возвращает:

Результат — объект Class

Исключения:

ClassNotFoundException - Если класс не был найден

protected Object getClassLoadingLock(String className)

Примечание API:

Этот метод позволяет многопоточным загрузчикам классов реализовывать более тонкую схему блокировки, чтобы несколько потоков могли загружать классы одновременно без тупиков. Для загрузчиков классов, не поддерживающих параллелизм, объект ClassLoader синхронизируется во время операций загрузки классов. Загрузчики классов с неиерархическим делегированием должны быть зарегистрированы как поддерживающие параллелизм для предотвращения тупиков.

Требования к реализации:

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

Параметры:

className - Имя класса, который необходимо загрузить

Возвращает:

Объект блокировки для операций загрузки классов

Исключения:

NullPointerException - Если зарегистрировано как поддерживающее параллелизм, и className имеет значение null

С:

1.7

См. также:

• loadClass(String, boolean)

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

Требования к реализации:

Реализация по умолчанию генерирует исключение ClassNotFoundException.

Параметры:

name - Бинарное имя класса

Возвращает:

Результат — объект Class

Исключения:

ClassNotFoundException - Если класс не был найден

С:

1.2

protected Class<?> findClass(String moduleName, String name)

Примечание API:

Этот метод возвращает null вместо генерации исключения ClassNotFoundException, если класс не был найден.

Требования к реализации:

Реализация по умолчанию пытается найти класс, вызывая findClass(String), когда модуль moduleName является null. В противном случае возвращается null.

Параметры:

moduleName - Имя модуля; или null, чтобы найти класс в безымянном модуле для этого загрузчика классов

name - Бинарное имя класса

Возвращает:

Результат — объект Class, или null, если класс не был найден.

С:

9

@Deprecated(since="1.1") protected final Class<?> defineClass(byte[] b, int off, int len) throws ClassFormatError

Параметры:

b - Байты, составляющие данные класса. Байты в позициях off по off+len-1 должны иметь формат допустимого файла класса, как определено в Спецификации виртуальной машины Java.

off - Начальный смещение в b данных класса

len - Длина данных класса

Возвращает:

Объект Class, созданный из указанных данных класса

Исключения:

ClassFormatError - Если данные не содержали допустимый класс

IndexOutOfBoundsException - Если либо off, либо len отрицательны, или если off+len больше, чем b.length.

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

См. также:

• loadClass(String, boolean)
• resolveClass(Class)

protected final Class<?> defineClass(String name, byte[] b, int off, int len) throws ClassFormatError

Параметры:

name - Ожидаемое имя бинарного файла класса, или null, если оно неизвестно

b - Байты, составляющие данные класса. Байты с позиций off по off+len-1 должны иметь формат файла класса, определённого в Спецификации виртуальной машины Java.

off - Начальный смещение в b данных класса.

len - Длина данных класса.

Возвращает:

Объект Class, созданный из указанных данных класса.

Исключения:

ClassFormatError - Если данные не содержат допустимого класса.

IndexOutOfBoundsException - Если либо off, либо len отрицательные, или если off+len больше, чем b.length.

SecurityException - Если предпринята попытка добавить этот класс в пакет, содержащий классы, подписанные другим набором сертификатов, чем этот класс (который не подписан), или если name начинается с "java.".

С:

1.1

См. также:

• loadClass(String, boolean)
• resolveClass(Class)
• CodeSource
• SecureClassLoader

protected final Class<?> defineClass(String name, byte[] b, int off, int len, ProtectionDomain protectionDomain) throws ClassFormatError

Параметры:

name - Ожидаемое имя бинарного файла класса, или null, если оно неизвестно

b - Байты, составляющие данные класса. Байты с позиций off по off+len-1 должны иметь формат файла класса, определённого в Спецификации виртуальной машины Java.

off - Начальный смещение в b данных класса.

len - Длина данных класса.

protectionDomain - ProtectionDomain класса.

Возвращает:

Объект Class, созданный из данных, и ProtectionDomain.

Исключения:

ClassFormatError - Если данные не содержат допустимого класса.

NoClassDefFoundError - Если name не равно null и не равно имени бинарного файла класса, указанного в b

IndexOutOfBoundsException - Если либо off, либо len отрицательные, или если off+len больше, чем b.length.

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

protected final Class<?> defineClass(String name, ByteBuffer b, ProtectionDomain protectionDomain) throws ClassFormatError

Параметры:

name - Ожидаемое имя бинарного файла. класса, или null, если оно неизвестно

b - Байты, составляющие данные класса. Байты с позиций b.position() по b.position() + b.limit() -1 должны иметь формат файла класса, определённого в Спецификации виртуальной машины Java.

protectionDomain - ProtectionDomain класса, или null.

Возвращает:

Объект Class, созданный из данных, и ProtectionDomain.

Исключения:

ClassFormatError - Если данные не содержат допустимого класса.

NoClassDefFoundError - Если name не равно null и не равно имени бинарного файла класса, указанного в b

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

С:

1.5

См. также:

• defineClass(String, byte[], int, int, ProtectionDomain)

protected final void resolveClass(Class<?> c)

Параметры:

c - Класс для связывания

Исключения:

NullPointerException - Если c равно null.

См. также:

• defineClass(String, byte[], int, int)

protected final Class<?> findSystemClass(String name) throws ClassNotFoundException

Parameters:

name - Имя двоичного файла класса

Returns:

Объект класса Class для указанного name

Throws:

ClassNotFoundException - Если класс не найден

See Also:

• ClassLoader(ClassLoader)
• getParent()

protected final Class<?> findLoadedClass(String name)

Parameters:

name - Имя двоичного файла класса

Returns:

Объект класса Class или null, если класс не загружен

Since:

1.1

protected final void setSigners(Class<?> c, Object[] signers)

Parameters:

c - Объект класса Class

signers - Подписывающие лица для класса

Since:

1.1

protected URL findResource(String moduleName, String name) throws IOException

API Note:

Этот метод является основой для методов Class.getResource, Class.getResourceAsStream и Module.getResourceAsStream. Он не подчиняется правилам инкапсуляции, заданным Module.getResourceAsStream.

Implementation Requirements:

Стандартная реализация пытается найти ресурс, вызвав findResource(String), когда moduleName является null. В противном случае возвращает null.

Parameters:

moduleName - Имя модуля; или null для поиска ресурса в безымянном модуле для этого загрузчика классов

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

Returns:

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

Throws:

IOException - Если произошли ошибки ввода-вывода

Since:

9

See Also:

• ModuleReader.find(String)

public URL getResource(String name)

API Note:

Когда несколько модулей определены в одном загрузчике классов, и более одного модуля содержит ресурс с заданным именем, порядок поиска модулей не определен и может быть очень непредсказуемым. При переопределении этого метода рекомендуется, чтобы реализация обеспечивала согласованность любой делегации с методом getResources(String).

Implementation Requirements:

Стандартная реализация сначала ищет ресурс в родительском загрузчике классов; если родительский загрузчик является null, то выполняется поиск по пути загрузчика классов, встроенного в виртуальную машину. Если не найден, этот метод вызовет findResource(String) для поиска ресурса.

Parameters:

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

Returns:

Объект URL для чтения ресурса; null, если ресурс не найден, URL не может быть построен для определения местоположения ресурса или ресурс находится в пакете, который не открыт безусловно.

Throws:

NullPointerException - Если name является null

Since:

1.1

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

API Note:

Когда несколько модулей определены в одном загрузчике классов, и более одного модуля содержит ресурс с заданным именем, порядок не определен и может быть очень непредсказуемым. При переопределении этого метода рекомендуется, чтобы реализация обеспечивала согласованность любой делегации с методом getResource(String). Это должно гарантировать, что первый элемент, возвращаемый методом nextElement перечисления, будет тем же ресурсом, что и ресурс, который вернул бы метод getResource(String).

Implementation Requirements:

Стандартная реализация сначала ищет ресурс в родительском загрузчике классов; если родительский загрузчик является null, выполняется поиск по пути загрузчика классов, встроенного в виртуальную машину. Затем вызывается findResources(String) для поиска ресурсов с именем в этом загрузчике классов. Возвращается перечисление, элементы которого являются URL-адресами, найденными при поиске в родительском загрузчике классов, за которым следуют элементы, найденные с помощью findResources.

Parameters:

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

Returns:

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

Throws:

IOException - Если произошли ошибки ввода-вывода

NullPointerException - Если name является null

Since:

1.2

public Stream<URL> resources(String name)

Примечание API:

При переопределении этого метода рекомендуется, чтобы реализация обеспечивала согласованность любой делегации с методом getResource(String). Это должно гарантировать, что первый элемент, возвращаемый потоком, является тем же ресурсом, который возвращал бы метод getResource(String).

Требования к реализации:

Встроенная реализация вызывает getResources для поиска всех ресурсов с заданным именем и возвращает поток с элементами в перечислении в качестве источника.

Параметры:

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

Возвращает:

Поток объектов ресурса URL. Если ресурсы не найдены, поток будет пустым. Ресурсы, для которых невозможно создать URL или которые находятся в пакете, не открытом безусловно, не будут включены в поток.

Выбрасывает:

NullPointerException — Если name является null

С:

9

protected URL findResource(String name)

Требования к реализации:

Встроенная реализация возвращает null.

Параметры:

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

Возвращает:

Объект URL для чтения ресурса; null если ресурс не найден, объект URL не смог построить местоположение ресурса или ресурс находится в пакете, который не открыт безусловно.

С:

1.2

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

Требования к реализации:

Встроенная реализация возвращает перечисление, не содержащее элементов.

Параметры:

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

Возвращает:

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

Выбрасывает:

IOException — Если возникают ошибки ввода-вывода

С:

1.2

protected static boolean registerAsParallelCapable()

Возвращает:

true, если вызывающий объект успешно зарегистрирован как поддерживающий параллельную работу, и false в противном случае.

Выбрасывает:

IllegalCallerException — если вызывающий объект не является подклассом ClassLoader

С:

1.7

См. также:

• isRegisteredAsParallelCapable()

public final boolean isRegisteredAsParallelCapable()

Возвращает:

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

С:

9

См. также:

• registerAsParallelCapable()

public static URL getSystemResource(String name)

Параметры:

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

Возвращает:

URL к ресурсу; null если ресурс не найден, URL не может быть создан для определения местоположения ресурса или ресурс находится в пакете, который не открыт безусловно.

С:

1.1

public static Enumeration<URL> getSystemResources(String name) throws IOException

Параметры:

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

Возвращает:

Перечисление объектов URL для ресурса. Если ресурсы не найдены, перечисление будет пустым. Ресурсы, для которых невозможно создать URL или которые находятся в пакете, не открытом безусловно, не возвращаются в перечислении.

Выбрасывает:

IOException — Если возникают ошибки ввода-вывода

С:

1.2

public InputStream getResourceAsStream(String name)

Параметры:

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

Возвращает:

Поток ввода для чтения ресурса; null если ресурс не найден или ресурс находится в пакете, который не открыт безусловно.

Выбрасывает:

NullPointerException — Если name является null

С:

1.1

public static InputStream getSystemResourceAsStream(String name)

Параметры:

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

Возвращает:

Поток ввода для чтения ресурса; null, если ресурс не найден или ресурс находится в пакете, который не открыт безусловно.

С:

1.1

public final ClassLoader getParent()

Возвращает:

Родительский загрузчик классов

С:

1.2

public final Module getUnnamedModule()

Возвращает:

Безымянный модуль для данного загрузчика классов

С:

9

См. также:

• Module.isNamed()

public static ClassLoader getPlatformClassLoader()

Примечание реализации:

Имя встроенного загрузчика платформенных классов — "platform".

Возвращает:

Платформенный загрузчик классов.

С:

9

public static ClassLoader getSystemClassLoader()

Примечание реализации:

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

Имя встроенного системного загрузчика классов — "app". Системная переменная "java.class.path" считывается во время ранней инициализации JVM, чтобы определить путь класса. Пустое значение свойства "java.class.path" интерпретируется по-разному в зависимости от того, является ли начальный модуль (модуль, содержащий главный класс) именованным или безымянным: если именованным, встроенный системный загрузчик классов не будет иметь путь класса и будет искать классы и ресурсы, используя путь модуля приложения; в противном случае, если безымянным, он установит путь класса в текущую рабочую директорию.

JAR-файлы в пути класса могут содержать атрибут Class-Path manifest для указания зависимых JAR-файлов, которые необходимо включить в путь класса. Class-Path записи должны удовлетворять определённым условиям для валидности (см. JAR-спецификацию файла для получения подробной информации). Некорректные Class-Path записи игнорируются. В отладочных целях проигнорированные записи могут быть напечатаны в консоль, если системная переменная jdk.net.URLClassPath.showIgnoredClassPathEntries установлена в true.

Возвращает:

Системный загрузчик классов

Исключения:

IllegalStateException - Если вызов выполняется рекурсивно во время создания загрузчика классов, указанного свойством "java.system.class.loader".

Error - Если системная переменная "java.system.class.loader" определена, но указанный класс не удалось загрузить, класс-поставщик не определяет требуемый конструктор или во время вызова этого конструктора возникает исключение. Основную причину ошибки можно получить с помощью метода Throwable.getCause().

protected Package definePackage(String name, String specTitle, String specVersion, String specVendor, String implTitle, String implVersion, String implVendor, URL sealBase)

Примечание API:

Загрузчик классов, который хочет определить пакет для классов в JAR, обычно использует заголовок, версия, поставщик из манифеста JAR. Если в манифесте JAR пакет определён как sealed, то URL файла JAR обычно используется в качестве sealBase. Если классы пакета 'p', определённые этим загрузчиком классов, загружаются из нескольких JAR, объект Package может содержать различную информацию в зависимости от первого класса пакета 'p', определённого и которого JAR-манифест был прочитан первым для явного определения пакета 'p'.

Настоятельно рекомендуется, чтобы загрузчик классов не вызывал этот метод для явного определения пакетов в именованных модулях; вместо этого пакет будет автоматически определён при определении класса. Если необходимо явно определить Package, то нужно убедиться, что все пакеты в именованном модуле определены со свойствами, указанными в Package. В противном случае, некоторые Package объекты в именованном модуле могут быть, например, sealed с разными seal base.

Параметры:

name - Имя пакета

specTitle - Название спецификации

specVersion - Версия спецификации

specVendor - Поставщик спецификации

implTitle - Название реализации

implVersion - Версия реализации

implVendor - Поставщик реализации

sealBase - Если не null, то этот пакет запечатан по отношению к указанному источнику кода URL объекту. В противном случае пакет не запечатан.

Возвращает:

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

Исключения:

NullPointerException - если name является null.

IllegalArgumentException - если пакет с указанным name уже определён этим загрузчиком классов

См. Спецификацию Java Virtual Machine:

5.3 Создание и загрузка

С:

1.2

См. также:

• JAR-спецификация файла: Запечатывание пакетов

public final Package getDefinedPackage(String name)

Параметры:

name - Имя пакета

Возвращает:

Объект пакета указанного имени, определённого этим загрузчиком классов, или null если не найден

Исключения:

NullPointerException - если name является null.

См. Спецификацию Java Virtual Machine:

5.3 Создание и загрузка

С:

9

public final Package[] getDefinedPackages()

API Note:

Этот метод возвращает массив, а не объект типа `Enumeration` или `Iterator`, для согласованности с существующим методом getPackages().

Returns:

Массив объектов `Package`, определённых этим загрузчиком классов; или массив нулевой длины, если пакеты этим загрузчиком не определены.

См. Спецификацию виртуальной машины Java:

5.3 Создание и загрузка

Since:

9

@Deprecated(since="9") protected Package getPackage(String name)

API Note:

Загрузчик платформенных классов (platform class loader) может делегировать запросы к загрузчику приложений, но загрузчик приложений не является его предком. При вызове на платформенном загрузчике этот метод не найдёт пакеты, определённые в загрузчике приложений.

Parameters:

name - Имя пакета

Returns:

Объект `Package` с заданным именем, определённый этим загрузчиком классов или его предками; или `null`, если не найден.

Throws:

NullPointerException - если name является null.

Since:

1.2

See Also:

• getDefinedPackage(String)

protected Package[] getPackages()

API Note:

Загрузчик платформенных классов (platform class loader) может делегировать запросы к загрузчику приложений. Иначе говоря, пакеты, определённые в модулях загрузчиком приложений, могут быть видимы загрузчику платформы. С другой стороны, загрузчик приложений не является его предком, и, следовательно, при вызове на платформенном загрузчике этот метод не вернёт пакеты, определённые в загрузчике приложений.

Returns:

Массив объектов `Package`, определённых этим загрузчиком классов и его предками

Since:

1.2

See Also:

• getDefinedPackages()

protected String findLibrary(String libname)

Parameters:

libname - Имя библиотеки

Returns:

Абсолютный путь к библиотеке

Since:

1.2

See Also:

• System.loadLibrary(String)^RESTRICTED
• System.mapLibraryName(String)

public void setDefaultAssertionStatus(boolean enabled)

Parameters:

enabled - `true`, если проверки включены по умолчанию для классов, загруженных этим загрузчиком, `false` - если выключены.

Since:

1.4

public void setPackageAssertionStatus(String packageName, boolean enabled)

Parameters:

packageName - Имя пакета, для которого необходимо установить значение по умолчанию для проверок. Значение `null` обозначает неназванный пакет (см. раздел 7.4.2 спецификации языка Java).

enabled - `true`, если проверки включены по умолчанию для классов, загруженных этим загрузчиком и относящихся к указанному пакету или его подпакетам; `false` - если выключены.

Since:

1.4

public void setClassAssertionStatus(String className, boolean enabled)

Parameters:

className - Полное имя класса верхнего уровня, для которого необходимо установить состояние проверок.

enabled - `true`, если проверки должны быть включены для указанного класса при его инициализации; `false` - если выключены.

Since:

1.4

public void clearAssertionStatus()

Since:

1.4