org.ka2ddo.yaac.pluginapi

Class AppendableURLClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.ka2ddo.yaac.pluginapi.AppendableURLClassLoader

All Implemented Interfaces:

java.io.Closeable, java.lang.AutoCloseable

public class AppendableURLClassLoader
extends java.net.URLClassLoader

This class extends the URLClassLoader class to allow more URLs to be added to the list in real-time, so plugins can dynamically add library JARs to their classpaths.

Since:

PROVIDER_API_VERSION == 47

Author:

Andrew Pavlin, KA2DDO

Constructor Summary

Constructors

Constructor and Description
AppendableURLClassLoader(java.net.URL[] urls) Create a new URLClassLoader using the specified array of URLs with no fallback ClassLoader.
AppendableURLClassLoader(java.net.URL[] urls, java.lang.ClassLoader classLoader) Create a new URLClassLoader using the specified array of URLs and parent ClassLoader.
AppendableURLClassLoader(java.net.URL[] urls, java.lang.ClassLoader classLoader, java.net.URLStreamHandlerFactory urlStreamHandlerFactory) Create a new URLClassLoader using the specified array of URLs and parent ClassLoader.

Method Summary

Modifier and Type	Method and Description
void	addURL(java.net.URL url) Append another URL to the list of URLs in this URLClassLoader.

Methods inherited from class java.net.URLClassLoader

close, definePackage, findClass, findResource, findResources, getPermissions, getResourceAsStream, getURLs, newInstance, newInstance

Methods inherited from class java.security.SecureClassLoader

defineClass, defineClass

Methods inherited from class java.lang.ClassLoader

clearAssertionStatus, defineClass, defineClass, defineClass, defineClass, definePackage, findLibrary, findLoadedClass, findSystemClass, getClassLoadingLock, getPackage, getPackages, getParent, getResource, getResources, getSystemClassLoader, getSystemResource, getSystemResourceAsStream, getSystemResources, loadClass, loadClass, registerAsParallelCapable, resolveClass, setClassAssertionStatus, setDefaultAssertionStatus, setPackageAssertionStatus, setSigners

Methods inherited from class java.lang.Object

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

Constructor Detail

AppendableURLClassLoader

public AppendableURLClassLoader(java.net.URL[] urls,
                                java.lang.ClassLoader classLoader)

Create a new URLClassLoader using the specified array of URLs and parent ClassLoader.

Parameters:

urls - array of URLs referencing classes

classLoader - ClassLoader to fallback to if this ClassLoader doesn't contain a needed class

AppendableURLClassLoader

public AppendableURLClassLoader(java.net.URL[] urls)

Create a new URLClassLoader using the specified array of URLs with no fallback ClassLoader.

Parameters:

urls - array of URLs referencing classes

AppendableURLClassLoader

public AppendableURLClassLoader(java.net.URL[] urls,
                                java.lang.ClassLoader classLoader,
                                java.net.URLStreamHandlerFactory urlStreamHandlerFactory)

Create a new URLClassLoader using the specified array of URLs and parent ClassLoader.

Parameters:

urls - array of URLs referencing classes

classLoader - ClassLoader to fallback to if this ClassLoader doesn't contain a needed class

urlStreamHandlerFactory - URLStreamHandlerFactory for reading the URLs

Method Detail

addURL

public void addURL(java.net.URL url)

Append another URL to the list of URLs in this URLClassLoader.

Overrides:

addURL in class java.net.URLClassLoader

Parameters:

url - URL to append (if not a duplicate of an existing URL in the URLClassLoader)