Package com.intellij.util.lang

Class UrlClassLoader

java.lang.Object

java.lang.ClassLoader

com.intellij.util.lang.UrlClassLoader

Direct Known Subclasses:

AntResourcesClassLoader, PluginClassLoader

public class UrlClassLoader
extends java.lang.ClassLoader

A class loader that allows for various customizations, e.g. not locking jars or using a special cache to speed up class loading. Should be constructed using build() method.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	UrlClassLoader.Builder
static interface	UrlClassLoader.CachePool An interface for a pool to store internal caches that can be shared between different class loaders, if they contain the same URLs in their class paths. The implementation is subject to change so one shouldn't rely on it.
static interface	UrlClassLoader.CachingCondition A condition to customize the caching policy when using UrlClassLoader.CachePool.

Constructor Summary

Constructors

Modifier	Constructor and Description
	UrlClassLoader(java.lang.ClassLoader parent) Deprecated. use build() (left for compatibility with `java.system.class.loader` setting)
protected	UrlClassLoader(UrlClassLoader.Builder builder)

Method Summary

Modifier and Type	Method and Description
protected java.lang.Class<?>	_defineClass(java.lang.String name, byte[] b)
protected java.lang.Class<?>	_defineClass(java.lang.String name, byte[] b, java.security.ProtectionDomain protectionDomain)
protected java.lang.Class<?>	_findClass(java.lang.String name)
void	addURL(java.net.URL url) Deprecated. adding URLs to a classloader at runtime could lead to hard-to-debug errors
static UrlClassLoader.Builder	build()
static UrlClassLoader.CachePool	createCachePool()
protected ClassPath	createClassPath(UrlClassLoader.Builder builder)
protected java.lang.Class<?>	findClass(java.lang.String name)
java.net.URL	findResource(java.lang.String name)
protected java.util.Enumeration<java.net.URL>	findResources(java.lang.String name)
java.util.List<java.net.URL>	getBaseUrls() See com.intellij.TestAll#getClassRoots()
protected java.lang.Object	getClassLoadingLock(java.lang.String className)
protected ClassPath	getClassPath()
java.util.Collection<java.lang.String>	getJarAccessLog()
java.io.InputStream	getResourceAsStream(java.lang.String name)
java.util.List<java.net.URL>	getUrls()
boolean	hasLoadedClass(java.lang.String name)
static java.net.URL	internProtocol(java.net.URL url) Interns a value of the URL.protocol ("file" or "jar") and URL.host (empty string) fields.
protected static void	markParallelCapable(java.lang.Class<? extends UrlClassLoader> loaderClass)

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findClass, findLibrary, findLoadedClass, findResource, findSystemClass, getDefinedPackage, getDefinedPackages, getName, getPackage, getPackages, getParent, getPlatformClassLoader, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, getUnnamedModule, isRegisteredAsParallelCapable, loadClass, loadClass, registerAsParallelCapable, resolveClass, resources, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Constructor Detail

UrlClassLoader

@Deprecated
public UrlClassLoader(java.lang.ClassLoader parent)

Deprecated. use build() (left for compatibility with `java.system.class.loader` setting)

UrlClassLoader

protected UrlClassLoader(UrlClassLoader.Builder builder)

Method Detail

markParallelCapable

protected static void markParallelCapable(java.lang.Class<? extends UrlClassLoader> loaderClass)

getClassPath

protected ClassPath getClassPath()

getBaseUrls

public java.util.List<java.net.URL> getBaseUrls()

See com.intellij.TestAll#getClassRoots()

getJarAccessLog

public java.util.Collection<java.lang.String> getJarAccessLog()

build

public static UrlClassLoader.Builder build()

createClassPath

protected final ClassPath createClassPath(UrlClassLoader.Builder builder)

internProtocol

public static java.net.URL internProtocol(java.net.URL url)

Interns a value of the URL.protocol ("file" or "jar") and URL.host (empty string) fields.

Returns:

interned URL or null if URL was malformed

addURL

@Deprecated
public void addURL(java.net.URL url)

Deprecated. adding URLs to a classloader at runtime could lead to hard-to-debug errors

getUrls

public java.util.List<java.net.URL> getUrls()

hasLoadedClass

public boolean hasLoadedClass(java.lang.String name)

findClass

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

Overrides:

findClass in class java.lang.ClassLoader

Throws:

java.lang.ClassNotFoundException

_findClass

protected final java.lang.Class<?> _findClass(java.lang.String name)

_defineClass

protected java.lang.Class<?> _defineClass(java.lang.String name,
                                          byte[] b)

_defineClass

protected java.lang.Class<?> _defineClass(java.lang.String name,
                                          byte[] b,
                                          java.security.ProtectionDomain protectionDomain)

findResource

public java.net.URL findResource(java.lang.String name)

Overrides:

findResource in class java.lang.ClassLoader

getResourceAsStream

public java.io.InputStream getResourceAsStream(java.lang.String name)

Overrides:

getResourceAsStream in class java.lang.ClassLoader

findResources

protected java.util.Enumeration<java.net.URL> findResources(java.lang.String name)
                                                     throws java.io.IOException

Overrides:

findResources in class java.lang.ClassLoader

Throws:

java.io.IOException

getClassLoadingLock

protected java.lang.Object getClassLoadingLock(java.lang.String className)

Overrides:

getClassLoadingLock in class java.lang.ClassLoader

createCachePool

public static UrlClassLoader.CachePool createCachePool()

Returns:

a new pool to be able to share internal caches between different class loaders, if they contain the same URLs in their class paths.