Класс RMIClassLoaderSpi
- java.lang.Object
-
- java.rmi.server.RMIClassLoaderSpi
public abstract class RMIClassLoaderSpi extends Object
RMIClassLoaderSpi является интерфейсом поставщика услуг для RMIClassLoader. В частности, экземпляр RMIClassLoaderSpi предоставляет реализацию следующих статических методов RMIClassLoader:
-
RMIClassLoader.loadClass(URL,String) -
RMIClassLoader.loadClass(String,String) -
RMIClassLoader.loadClass(String,String,ClassLoader) -
RMIClassLoader.loadProxyClass(String,String[],ClassLoader) -
RMIClassLoader.getClassLoader(String) -
RMIClassLoader.getClassAnnotation(Class)
RMIClassLoader для описания выбора экземпляра поставщика.
- Since:
- 1.4
- See Also:
RMIClassLoader
Конструкторы
| Конструктор и описание |
|---|
RMIClassLoaderSpi()
|
Методы
| Модификатор и тип | Метод и описание |
|---|---|
abstract String |
getClassAnnotation(Class<?> cl) Предоставляет реализацию для |
abstract ClassLoader |
getClassLoader(String codebase) Предоставляет реализацию для |
abstract Class<?> |
loadClass(String codebase,
String name,
ClassLoader defaultLoader) Предоставляет реализацию для |
abstract Class<?> |
loadProxyClass(String codebase,
String[] interfaces,
ClassLoader defaultLoader) Предоставляет реализацию для |
Методы, унаследованные от класса java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
Конструкторы
RMIClassLoaderSpi
public RMIClassLoaderSpi()
Методы
loadClass
public abstract Class<?> loadClass(String codebase,
String name,
ClassLoader defaultLoader)
throws MalformedURLException,
ClassNotFoundException
Предоставляет реализацию для RMIClassLoader.loadClass(URL,String), RMIClassLoader.loadClass(String,String) и RMIClassLoader.loadClass(String,String,ClassLoader). Загружает класс из пути URL кодовой базы, при необходимости, используя предоставленный загрузчик. Обычно реализация поставщика попытается разрешить именованный класс с использованием указанного defaultLoader, если он указан, прежде чем попытаться разрешить класс из пути URL кодовой базы.
Реализация этого метода должна либо вернуть класс с заданным именем, либо выбросить исключение.
- Parameters:
-
codebase- список URL-адресов (разделенных пробелами) для загрузки класса, илиnull -
name- имя загружаемого класса -
defaultLoader- дополнительный контекстный загрузчик классов для использования, илиnull - Returns:
- объект
Class, представляющий загруженный класс - Throws:
-
MalformedURLException- еслиcodebaseнеnullи содержит недопустимый URL, или еслиcodebasenullи используемый поставщиком URL для загрузки классов недопустим -
ClassNotFoundException- если определение класса не найдено в указанном месте
loadProxyClass
public abstract Class<?> loadProxyClass(String codebase,
String[] interfaces,
ClassLoader defaultLoader)
throws MalformedURLException,
ClassNotFoundException
Предоставляет реализацию для RMIClassLoader.loadProxyClass(String,String[],ClassLoader). Загружает динамический класс прокси (см. Proxy), который реализует набор интерфейсов с заданными именами из пути URL кодовой базы, при необходимости, используя предоставленный загрузчик.
Реализация этого метода должна либо вернуть класс прокси, реализующий указанные интерфейсы, либо выбросить исключение.
- Parameters:
-
codebase- список URL-адресов (разделенных пробелами) для загрузки классов, илиnull -
interfaces- имена интерфейсов для реализации классом прокси -
defaultLoader- дополнительный контекстный загрузчик классов для использования, илиnull - Returns:
- динамический класс прокси, реализующий указанные интерфейсы
- Throws:
-
MalformedURLException- еслиcodebaseнеnullи содержит недопустимый URL, или еслиcodebasenullи используемый поставщиком URL для загрузки классов недопустим -
ClassNotFoundException- если определение одного из именованных интерфейсов не найдено в указанном месте или если создание динамического класса прокси завершилось неудачей (например, еслиProxy.getProxyClass(ClassLoader,Class[])выброситIllegalArgumentExceptionдля данного списка интерфейсов)
getClassLoader
public abstract ClassLoader getClassLoader(String codebase)
throws MalformedURLException
Предоставляет реализацию для RMIClassLoader.getClassLoader(String). Возвращает загрузчик классов, который загружает классы из заданного пути URL кодовой базы.
Если есть менеджер безопасности, его метод checkPermission будет вызван с разрешением RuntimePermission("getClassLoader"); это может привести к SecurityException. Реализация этого метода также может выполнить дополнительные проверки безопасности, чтобы убедиться, что вызывающий контекст имеет разрешение на подключение ко всем URL-адресам в пути URL кодовой базы.
- Parameters:
-
codebase- список URL-адресов (разделенных пробелами), из которых возвращаемый загрузчик классов будет загружать классы, илиnull - Returns:
- загрузчик классов, который загружает классы из заданного пути URL кодовой базы
- Throws:
-
MalformedURLException- еслиcodebaseнеnullи содержит недопустимый URL, или еслиcodebasenullи используемый поставщиком URL для идентификации загрузчика классов недопустим -
SecurityException- если есть менеджер безопасности и вызов его методаcheckPermissionзавершился неудачей или если вызывающий контекст не имеет разрешения на подключение ко всем URL-адресам в пути URL кодовой базы
getClassAnnotation
public abstract String getClassAnnotation(Class<?> cl)
Предоставляет реализацию для RMIClassLoader.getClassAnnotation(Class). Возвращает строку аннотации (представляющую расположение определения класса), которую RMI будет использовать для аннотации описания класса при сериализации объектов данного класса.
- Parameters:
-
cl- класс, для которого требуется получить аннотацию - Returns:
- строка, используемая для аннотации данного класса при его сериализации, или
null - Throws:
-
NullPointerException- еслиclnull
© 1993, 2020, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.