java.rmi.server

Класс RMIClassLoader

java.lang. Объект

java.rmi.server. RMIClassLoader

public class RMIClassLoader
extends Object

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

Реализация следующих статических методов

• loadClass(URL,String)
• loadClass(String,String)
• loadClass(String,String,ClassLoader)
• loadProxyClass(String,String[],ClassLoader)
• getClassLoader(String)
• getClassAnnotation(Class)

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

Экземпляр поставщика услуг выбирается следующим образом:

• Если системное свойство java.rmi.server.RMIClassLoaderSpi определяется, затем если его значение равняется строке "default", экземпляр провайдера будет значением, возвращенным вызовом getDefaultProviderInstance() метод, и для любого другого значения, если класс, названный со значением свойства, может быть загружен системным загрузчиком класса (см. ClassLoader.getSystemClassLoader()) и тот класс присваиваем RMIClassLoaderSpi и имеет общедоступного конструктора без параметров, тогда тот конструктор будет вызван, чтобы создать экземпляр провайдера. Если свойство определяется, но любые другие из тех условий не являются истиной, то неуказанное Error будет брошен, чтобы кодировать, который пытается использовать RMIClassLoader, указание на отказ получить экземпляр провайдера.
• Если ресурс называют META-INF/services/java.rmi.server.RMIClassLoaderSpi видимо к системному загрузчику класса, тогда содержание того ресурса интерпретируется как конфигурационный файл провайдера, и имя первого класса, определенное в том файле, используется в качестве имени класса провайдера. Если класс с тем именем может быть загружен системным загрузчиком класса, и тот класс присваиваем RMIClassLoaderSpi и имеет общедоступного конструктора без параметров, тогда тот конструктор будет вызван, чтобы создать экземпляр провайдера. Если ресурс находится, но провайдер нельзя инстанцировать как описано, то неуказанное Error будет брошен, чтобы кодировать, который пытается использовать RMIClassLoader, указание на отказ получить экземпляр провайдера.
• Иначе, экземпляр провайдера будет значением, возвращенным вызовом getDefaultProviderInstance() метод.

С тех пор:

JDK1.1

См. Также:

RMIClassLoaderSpi

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

Методы

Модификатор и Тип	Метод и Описание
static String	getClassAnnotation(Class<?> cl) Возвращает строку аннотации (представляющий расположение для определения класса), который RMI будет использовать, чтобы аннотировать дескриптор класса, упорядочивая объекты данного класса.
static ClassLoader	getClassLoader(String codebase) Возвращает загрузчик класса, который загружает классы из данной кодовой базы путь URL.
static RMIClassLoaderSpi	getDefaultProviderInstance() Возвращает канонический экземпляр провайдера по умолчанию для интерфейса поставщика услуг RMIClassLoaderSpi.
static Object	getSecurityContext(ClassLoader loader) Осуждаемый. никакая замена. С Java 2 платформы v1.2, RMI больше не использует этот метод, чтобы получить контекст защиты загрузчика класса.
static Class<?>	loadClass(String name) Осуждаемый. замененный loadClass(String,String) метод
static Class<?>	loadClass(String codebase, String name) Загружает класс из кодовой базы путь URL.
static Class<?>	loadClass(String codebase, String name, ClassLoader defaultLoader) Загружает класс из кодовой базы путь URL, дополнительно используя предоставленный загрузчик.
static Class<?>	loadClass(URL codebase, String name) Загружает класс из кодовой базы URL.
static Class<?>	loadProxyClass(String codebase, String[] interfaces, ClassLoader defaultLoader) Загружает динамический прокси-класс (см. Proxy) это реализует ряд интерфейсов с именами от кодовой базы путь URL.

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

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

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

loadClass

@Deprecated
public static Class<?> loadClass(String name)
                          throws MalformedURLException,
                                 ClassNotFoundException

Осуждаемый. замененный loadClass(String,String) метод

Загружает класс указанным name.

Этот метод делегирует к loadClass(String,String), передача null как первый параметр и name как второй параметр.

Параметры:

name - имя класса загрузки

Возвраты:

Class объект, представляющий загруженный класс

Броски:

MalformedURLException - если специфичный для провайдера URL, используемый, чтобы загрузить классы, недопустим

ClassNotFoundException - если определение для класса не могло бы быть найдено в расположении кодовой базы

См. Также:

loadClass(String,String)

loadClass

public static Class<?> loadClass(URL codebase,
                 String name)
                          throws MalformedURLException,
                                 ClassNotFoundException

Загружает класс из кодовой базы URL. Если codebase null, тогда этот метод будет вести себя то же самое как loadClass(String,String) с a null codebase и данное имя класса.

Этот метод делегирует к RMIClassLoaderSpi.loadClass(String,String,ClassLoader) метод экземпляра провайдера, передавая результат вызова URL.toString() на данном URL (или null если codebase нуль) как первый параметр, name как второй параметр, и null как третий параметр.

Параметры:

codebase - URL, чтобы загрузить класс из, или null

name - имя класса загрузки

Возвраты:

Class объект, представляющий загруженный класс

Броски:

MalformedURLException - если codebase null и специфичный для провайдера URL, используемый, чтобы загрузить классы, недопустим

ClassNotFoundException - если определение для класса не могло бы быть найдено в указанном URL

loadClass

public static Class<?> loadClass(String codebase,
                 String name)
                          throws MalformedURLException,
                                 ClassNotFoundException

Загружает класс из кодовой базы путь URL.

Этот метод делегирует к RMIClassLoaderSpi.loadClass(String,String,ClassLoader) метод экземпляра провайдера, передавая codebase как первый параметр, name как второй параметр, и null как третий параметр.

Параметры:

codebase - список URL (разделенный пробелами), чтобы загрузить класс из, или null

name - имя класса загрузки

Возвраты:

Class объект, представляющий загруженный класс

Броски:

MalformedURLException - если codebase не -null и содержит недопустимый URL, или если codebase null и специфичный для провайдера URL, используемый, чтобы загрузить классы, недопустим

ClassNotFoundException - если определение для класса не могло бы быть найдено в указанном расположении

С тех пор:

1.2

loadClass

public static Class<?> loadClass(String codebase,
                 String name,
                 ClassLoader defaultLoader)
                          throws MalformedURLException,
                                 ClassNotFoundException

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

Этот метод делегирует к RMIClassLoaderSpi.loadClass(String,String,ClassLoader) метод экземпляра провайдера, передавая codebase как первый параметр, name как второй параметр, и defaultLoader как третий параметр.

Параметры:

codebase - список URL (разделенный пробелами), чтобы загрузить класс из, или null

name - имя класса загрузки

defaultLoader - дополнительный контекстный загрузчик класса, чтобы использовать, или null

Возвраты:

Class объект, представляющий загруженный класс

Броски:

MalformedURLException - если codebase не -null и содержит недопустимый URL, или если codebase null и специфичный для провайдера URL, используемый, чтобы загрузить классы, недопустим

ClassNotFoundException - если определение для класса не могло бы быть найдено в указанном расположении

С тех пор:

1.4

loadProxyClass

public static Class<?> loadProxyClass(String codebase,
                      String[] interfaces,
                      ClassLoader defaultLoader)
                               throws ClassNotFoundException,
                                      MalformedURLException

Загружает динамический прокси-класс (см. Proxy) это реализует ряд интерфейсов с именами от кодовой базы путь URL.

Интерфейсы будут разрешены подобные классам, загруженным через loadClass(String,String) метод используя данный codebase.

Этот метод делегирует к RMIClassLoaderSpi.loadProxyClass(String,String[],ClassLoader) метод экземпляра провайдера, передавая codebase как первый параметр, interfaces как второй параметр, и defaultLoader как третий параметр.

Параметры:

codebase - список URL (разделенных пробелом), чтобы загрузить классы из, или null

interfaces - имена интерфейсов для прокси-класса, чтобы реализовать

defaultLoader - дополнительный контекстный загрузчик класса, чтобы использовать, или null

Возвраты:

динамический прокси-класс, который реализует именованные интерфейсы

Броски:

MalformedURLException - если codebase не -null и содержит недопустимый URL, или если codebase null и специфичный для провайдера URL, используемый, чтобы загрузить классы, недопустим

ClassNotFoundException - если определение для одного из именованных интерфейсов не могло бы быть найдено в указанном расположении, или если создание динамического отказавшего прокси-класса (такой, как будто Proxy.getProxyClass(ClassLoader,Class[]) бросил бы IllegalArgumentException для данного интерфейсного списка)

С тех пор:

1.4

getClassLoader

public static ClassLoader getClassLoader(String codebase)
                                  throws MalformedURLException,
                                         SecurityException

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

Возвращенный загрузчик класса является загрузчиком класса что loadClass(String,String) метод использовал бы, чтобы загрузить классы для того же самого codebase параметр.

Этот метод делегирует к RMIClassLoaderSpi.getClassLoader(String) метод экземпляра провайдера, передавая codebase как параметр.

Если есть кормушка безопасности, checkPermission метод будет вызван с a RuntimePermission("getClassLoader") разрешение; это могло привести к a SecurityException. Реализация провайдера этого метода может также выполнить дальнейшие проверки безопасности, чтобы проверить, что у контекста вызова есть разрешение, чтобы соединить со всеми URL в кодовой базе путь URL.

Параметры:

codebase - список URL (разделенных пробелом), от которого возвращенный загрузчик класса загрузит классы из, или null

Возвраты:

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

Броски:

MalformedURLException - если codebase не -null и содержит недопустимый URL, или если codebase null и специфичный для провайдера URL, используемый, чтобы идентифицировать загрузчик класса, недопустим

SecurityException - если есть менеджер безопасности и вызов checkPermission сбои метода, или если у вызывающей стороны нет разрешения, чтобы соединить со всеми URL в кодовой базе путь URL

С тех пор:

1.3

getClassAnnotation

public static String getClassAnnotation(Class<?> cl)

Возвращает строку аннотации (представляющий расположение для определения класса), который RMI будет использовать, чтобы аннотировать дескриптор класса, упорядочивая объекты данного класса.

Этот метод делегирует к RMIClassLoaderSpi.getClassAnnotation(Class) метод экземпляра провайдера, передавая cl как параметр.

Параметры:

cl - класс, чтобы получить аннотацию для

Возвраты:

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

Броски:

NullPointerException - если cl null

С тех пор:

1.2

getDefaultProviderInstance

public static RMIClassLoaderSpi getDefaultProviderInstance()

Возвращается канонический экземпляр провайдера по умолчанию для поставщика услуг соединяют интерфейсом RMIClassLoaderSpiс . Если системное свойство java.rmi.server.RMIClassLoaderSpi не определяется, тогда RMIClassLoader статические методы

• loadClass(URL,String)
• loadClass(String,String)
• loadClass(String,String,ClassLoader)
• loadProxyClass(String,String[],ClassLoader)
• getClassLoader(String)
• getClassAnnotation(Class)

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

Если есть менеджер безопасности, checkPermission метод будет вызван с a RuntimePermission("setFactory") разрешение; это могло привести к a SecurityException.

Реализации экземпляра поставщика услуг по умолчанию RMIClassLoaderSpi следующим образом:

getClassAnnotation метод возвращает a String представление кодовой базы путь URL, который удаленная сторона должна использовать, чтобы загрузить определение для указанного класса. Формат возвращенной строки является путем URL, разделенных пробелами. Возвращенная строка кодовой базы зависит от загрузчика класса определения указанного класса:

• Если загрузчик класса является системным загрузчиком класса (см. ClassLoader.getSystemClassLoader()), родитель системного загрузчика класса, такого как загрузчик, используемый для установленных расширений, или загрузчика класса начальной загрузки (который может быть представлен null), тогда значение java.rmi.server.codebase свойство (или возможно более раннее кэшируемое значение) возвращается, или null возвращается, если то свойство не устанавливается.

• Иначе, если загрузчик класса является экземпляром URLClassLoader, тогда возвращенная строка является разделенным пробелом списком внешних форм URL, возвращенных, вызывая getURLs методы загрузчика. Если URLClassLoader создавался этим провайдером, чтобы обслужить вызов loadClass или loadProxyClass методы, тогда никакие полномочия не обязаны получать связанную строку кодовой базы. Если это - произвольный другой URLClassLoader экземпляр, затем если есть менеджер безопасности, checkPermission метод будет вызван однажды для каждого URL, возвращенного getURLs метод, с разрешением, возвращенным, вызывая openConnection().getPermission() на каждом URL; если какой-либо из тех вызовов бросает a SecurityException или IOException, тогда значение java.rmi.server.codebase свойство (или возможно более раннее кэшируемое значение) возвращается, или null возвращается, если то свойство не устанавливается.

• Наконец, если загрузчик класса не является экземпляром URLClassLoader, тогда значение java.rmi.server.codebase свойство (или возможно более раннее кэшируемое значение) возвращается, или null возвращается, если то свойство не устанавливается.

Для реализаций методов, описанных ниже, который все берут a String параметр называют codebase это - разделенный пробелом список URL, у каждого вызова есть связанный загрузчик кодовой базы, который идентифицируется, используя codebase параметр в соединении с загрузчиком класса контекста текущего потока (см. Thread.getContextClassLoader()). Когда есть менеджер безопасности, этот провайдер поддерживает внутреннюю таблицу экземпляров загрузчика класса (которые являются, по крайней мере, экземплярами URLClassLoader) включенный парой их загрузчика родительского класса и их кодовой базы путь URL (упорядоченный список URL). Если codebase параметр null, кодовая база путь URL является значением системного свойства java.rmi.server.codebase или возможно более раннее кэшируемое значение. Для данной кодовой базы путь URL, который передают как codebase параметр вызову одного из ниже методов в данном контексте, загрузчик кодовой базы является загрузчиком в таблице с указанной кодовой базой путь URL и загрузчик класса контекста текущего потока как его родитель. Если никакой такой загрузчик не существует, то каждый создается и добавляется к таблице. Таблица не поддерживает сильные ссылки на свои содержавшие загрузчики, чтобы позволить им и их определенным классам быть собранными "мусор" если не иначе достижимые. Чтобы препятствовать тому, чтобы произвольный недоверяемый код был неявно загружен в виртуальную машину без менеджера безопасности, если нет никакого набора менеджера безопасности, загрузчик кодовой базы является только загрузчиком класса контекста текущего потока (предоставленная кодовая база, путь URL игнорируется, таким образом, удаленная загрузка класса отключается).

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

loadClass метод пытается загрузить класс указанным именем следующим образом:

Если defaultLoader параметр не -null, это сначала пытается загрузить класс указанным name использование defaultLoader, такой как, оценивая

     Class.forName(name, false, defaultLoader)
 

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

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

loadProxyClass метод пытается возвратить динамический прокси-класс с именованным интерфейсом следующим образом:

Если defaultLoader параметр не -null и все именованные интерфейсы могут быть разрешены через тот загрузчик, тогда,

• если все разрешенные интерфейсы public, тогда это сначала пытается получить динамический прокси-класс (использование Proxy.getProxyClass) для разрешенных интерфейсов, определенных в загрузчике кодовой базы; если та попытка бросает IllegalArgumentException, это тогда пытается получить динамический прокси-класс для разрешенных интерфейсов, определенных в defaultLoader. Если обе попытки бросают IllegalArgumentException, тогда этот метод бросает a ClassNotFoundException. Если какое-либо другое исключение выдается, то исключение выдается к вызывающей стороне.
• если весь из не -public разрешенные интерфейсы определяются в том же самом загрузчике класса, тогда он пытается получить динамический прокси-класс для разрешенных интерфейсов, определенных в том загрузчике.
• иначе, a LinkageError бросается (потому что класс, который реализует все указанные интерфейсы, не может быть определен ни в каком загрузчике).

Иначе, если все именованные интерфейсы могут быть разрешены через загрузчик кодовой базы, то,

• если все разрешенные интерфейсы public, тогда это пытается получить динамический прокси-класс для разрешенных интерфейсов в загрузчике кодовой базы. Если попытка бросает IllegalArgumentException, тогда этот метод бросает a ClassNotFoundException.
• если весь из не -public разрешенные интерфейсы определяются в том же самом загрузчике класса, тогда он пытается получить динамический прокси-класс для разрешенных интерфейсов, определенных в том загрузчике.
• иначе, a LinkageError бросается (потому что класс, который реализует все указанные интерфейсы, не может быть определен ни в каком загрузчике).

Иначе, a ClassNotFoundException бросается для одного из именованных интерфейсов, которые не могли быть разрешены.

Возвраты:

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

Броски:

SecurityException - если есть менеджер безопасности и вызов checkPermission сбои метода

С тех пор:

1.4

getSecurityContext

@Deprecated
public static Object getSecurityContext(ClassLoader loader)

Осуждаемый. никакая замена. С Java 2 платформы v1.2, RMI больше не использует этот метод, чтобы получить контекст защиты загрузчика класса.

Возвращает контекст защиты данного загрузчика класса.

Параметры:

loader - загрузчик класса, от которого можно получить контекст защиты

Возвраты:

контекст защиты

См. Также:

SecurityManager.getSecurityContext()