Класс RMIClassLoader

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

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

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

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

Загружает класс по пути в кодовом базисе.

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

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

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

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

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

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

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

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

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

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

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

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

Возвращает канонический экземпляр по умолчанию для интерфейса поставщика сервисов 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 будет вызван с разрешением RuntimePermission("setFactory"); это может привести к SecurityException.

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

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

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

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

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

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

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

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

If the defaultLoader argument is non-null, it first attempts to load the class with the specified name using the defaultLoader, such as by evaluating
     Class.forName(name, false, defaultLoader)
  If the class is successfully loaded from the defaultLoader, that class is returned. If an exception other than ClassNotFoundException is thrown, that exception is thrown to the caller. Next, the loadClass method attempts to load the class with the specified name using the codebase loader for the specified codebase URL path. If there is a security manager, then the calling context must have permission to connect to all of the URLs in the codebase URL path; otherwise, the current thread's context class loader will be used instead of the codebase loader.

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

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

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

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

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

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