com.jivesoftware.base.plugin
Class PluginClassLoader

java.lang.Object
  com.jivesoftware.base.plugin.PluginClassLoader

public class PluginClassLoader
extends java.lang.Object

ClassLoader for plugins. It searches the plugin directory for classes and JAR files, then constructs a class loader for the resources found. Resources are loaded as follows:

• Any JAR files in the lib will be added to the classpath.
• Any files in the classes directory will be added to the classpath.

Constructor Summary

PluginClassLoader()
Constructs a plugin loader for the given plugin directory.

Method Summary

void	addDirectory(java.io.File directory) Adds a directory to the class loader.
void	addURL(java.net.URL url) Adds a URL to the class loader.
void	destroy() Destroys this class loader.
java.lang.ClassLoader	getClassLoader() Returns the URLClassloader used.
java.util.Collection	getURLS()
void	initialize() Initializes the class loader with all configured classpath URLs.
java.lang.Class	loadClass(java.lang.String name) Load a class using this plugin class loader.

Methods inherited from class java.lang.Object

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

Constructor Detail

PluginClassLoader

public PluginClassLoader()
                  throws java.lang.SecurityException

Constructs a plugin loader for the given plugin directory.

Throws:

java.lang.SecurityException - if the created class loader violates existing security constraints.

Method Detail

addDirectory

public void addDirectory(java.io.File directory)

Adds a directory to the class loader. The initialize() method should be called after adding the directory to make the change take effect.

Parameters:

directory - the directory.

getURLS

public java.util.Collection getURLS()

addURL

public void addURL(java.net.URL url)

Adds a URL to the class loader. The initialize() method should be called after adding the URL to make the change take effect.

Parameters:

url - the url.

initialize

public void initialize()

Initializes the class loader with all configured classpath URLs. This method can be called multiple times if the list of URLs changes.

loadClass

public java.lang.Class loadClass(java.lang.String name)
                          throws java.lang.ClassNotFoundException

Load a class using this plugin class loader.

Parameters:

name - the fully qualified name of the class to load.

Returns:

The module object loaded

Throws:

java.lang.ClassNotFoundException - if the class could not be loaded by this class loader.

java.lang.SecurityException - if the custom class loader not allowed.

destroy

public void destroy()

Destroys this class loader.

getClassLoader

public java.lang.ClassLoader getClassLoader()

Returns the URLClassloader used.

Returns:

the URLClassLoader used.