URLClassLoader

public class URLClassLoader extends SecureClassLoader

This class loader is responsible for loading classes and resources from a list of URLs which can refer to either directories or JAR files. Classes loaded by this URLClassLoader are granted permission to access the URLs contained in the URL search list. This version has been simplified, since iOS is prohibited from dynamically loading classes from bundles other than the main app bundle. No code was shared, just its public API.

Public Constructor Summary

	URLClassLoader(URL[] urls) Constructs a new URLClassLoader instance.
	URLClassLoader(URL[] urls, ClassLoader parent) Constructs a new URLClassLoader instance.
	URLClassLoader(URL[] searchUrls, ClassLoader parent, URLStreamHandlerFactory factory) Constructs a new URLClassLoader instance.

Public Method Summary

void	close() Closes this classLoader, so it can't be used to load new classes or resources.
Enumeration<URL>	findResources(String name) Returns all known URLs which point to the specified resource.
URL[]	getURLs() Returns the search list of this URLClassLoader.
static URLClassLoader	newInstance(URL[] urls) Returns a new URLClassLoader instance for the given URLs and the system ClassLoader as its parent.
static URLClassLoader	newInstance(URL[] urls, ClassLoader parentCl) Returns a new URLClassLoader instance for the given URLs and the specified ClassLoader as its parent.

Protected Method Summary

void	addURL(URL url) Adds the specified URL to the search list.

Inherited Method Summary

From class java.security.SecureClassLoader

final Class<?>	defineClass(String name, byte[] b, int off, int len, CodeSource cs) Converts an array of bytes into an instance of class Class, with an optional CodeSource.
final Class<?>	defineClass(String name, ByteBuffer b, CodeSource cs) Converts a ByteBuffer into an instance of class Class, with an optional CodeSource.
PermissionCollection	getPermissions(CodeSource codesource) Returns the permissions for the given CodeSource object.

From class java.lang.ClassLoader

void	clearAssertionStatus() Sets the default assertion status for this class loader to false and discards any package defaults or class assertion status settings associated with the class loader.
final Class<?>	defineClass(String name, byte[] b, int off, int len, ProtectionDomain protectionDomain) Converts an array of bytes into an instance of class Class, with an optional ProtectionDomain.
final Class<?>	defineClass(String name, ByteBuffer b, ProtectionDomain protectionDomain) Converts a ByteBuffer into an instance of class Class, with an optional ProtectionDomain.
final Class<?>	defineClass(byte[] b, int off, int len) This method is deprecated. Replaced by defineClass(String, byte[], int, int)
final Class<?>	defineClass(String name, byte[] b, int off, int len) Converts an array of bytes into an instance of class Class.
Package	definePackage(String name, String specTitle, String specVersion, String specVendor, String implTitle, String implVersion, String implVendor, URL sealBase) Defines a package by name in this ClassLoader.
Class<?>	findClass(String name) Finds the class with the specified binary name.
String	findLibrary(String libname) Returns the absolute path name of a native library.
final Class<?>	findLoadedClass(String name) Returns the class with the given binary name if this loader has been recorded by the Java virtual machine as an initiating loader of a class with that binary name.
URL	findResource(String name) Finds the resource with the given name.
Enumeration<URL>	findResources(String name) Returns an enumeration of URL objects representing all the resources with the given name.
final Class<?>	findSystemClass(String name) Finds a class with the specified binary name, loading it if necessary.
Package	getPackage(String name) Returns a Package that has been defined by this class loader or any of its ancestors.
Package[]	getPackages() Returns all of the Packages defined by this class loader and its ancestors.
final ClassLoader	getParent() Returns the parent class loader for delegation.
URL	getResource(String name) Finds the resource with the given name.
InputStream	getResourceAsStream(String name) Returns an input stream for reading the specified resource.
Enumeration<URL>	getResources(String name) Finds all the resources with the given name.
static ClassLoader	getSystemClassLoader() Returns the system class loader for delegation.
static URL	getSystemResource(String name) Find a resource of the specified name from the search path used to load classes.
static InputStream	getSystemResourceAsStream(String name) Open for reading, a resource of the specified name from the search path used to load classes.
static Enumeration<URL>	getSystemResources(String name) Finds all resources of the specified name from the search path used to load classes.
Class<?>	loadClass(String name, boolean resolve) Loads the class with the specified binary name.
Class<?>	loadClass(String name) Loads the class with the specified binary name.
static boolean	registerAsParallelCapable() Registers the caller as parallel capable.
final void	resolveClass(Class<?> c) Links the specified class.
void	setClassAssertionStatus(String className, boolean enabled) Sets the desired assertion status for the named top-level class in this class loader and any nested classes contained therein.
void	setDefaultAssertionStatus(boolean enabled) Sets the default assertion status for this class loader.
void	setPackageAssertionStatus(String packageName, boolean enabled) Sets the package default assertion status for the named package.
final void	setSigners(Class<?> c, Object[] signers) Sets the signers of a class.

From class java.lang.Object

Object	clone() Creates and returns a copy of this Object.
boolean	equals(Object obj) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of Class that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the wait() methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait(long timeout, int nanos) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait(long timeout) Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object or until the specified timeout expires.
final void	wait() Causes the calling thread to wait until another thread calls the notify() or notifyAll() method of this object.

Public Constructors

public URLClassLoader (URL[] urls)

Constructs a new URLClassLoader instance. The newly created instance will have the system ClassLoader as its parent. URLs that end with "/" are assumed to be directories, otherwise they are assumed to be JAR files.

Parameters

urls	the list of URLs where a specific class or file could be found.

public URLClassLoader (URL[] urls, ClassLoader parent)

Constructs a new URLClassLoader instance. The newly created instance will have the system ClassLoader as its parent. URLs that end with "/" are assumed to be directories, otherwise they are assumed to be JAR files.

Parameters

urls	the list of URLs where a specific class or file could be found.
parent	the class loader to assign as this loader's parent.

public URLClassLoader (URL[] searchUrls, ClassLoader parent, URLStreamHandlerFactory factory)

Constructs a new URLClassLoader instance. The newly created instance will have the specified ClassLoader as its parent and use the specified factory to create stream handlers. URLs that end with "/" are assumed to be directories, otherwise they are assumed to be JAR files.

Parameters

searchUrls	the list of URLs where a specific class or file could be found.
parent	the ClassLoader to assign as this loader's parent.
factory	the factory that will be used to create protocol-specific stream handlers.

Public Methods

public void close ()

Closes this classLoader, so it can't be used to load new classes or resources.

Throws

IOException

public Enumeration<URL> findResources (String name)

Returns all known URLs which point to the specified resource.

Parameters

name	the name of the requested resource.

Returns

• the enumeration of URLs which point to the specified resource.

Throws

IOException	if an I/O error occurs while attempting to connect.

public URL[] getURLs ()

Returns the search list of this URLClassLoader.

Returns

• the list of all known URLs of this instance.

public static URLClassLoader newInstance (URL[] urls)

Returns a new URLClassLoader instance for the given URLs and the system ClassLoader as its parent.

Parameters

urls	the list of URLs that is passed to the new URLClassLoader.

Returns

• the created URLClassLoader instance.

public static URLClassLoader newInstance (URL[] urls, ClassLoader parentCl)

Returns a new URLClassLoader instance for the given URLs and the specified ClassLoader as its parent.

Parameters

urls	the list of URLs that is passed to the new URLClassLoader.
parentCl	the parent class loader that is passed to the new URLClassLoader.

Returns

• the created URLClassLoader instance.

Protected Methods

protected void addURL (URL url)

Adds the specified URL to the search list.

Parameters

url	the URL which is to add.