org.plugface.core.internal

Class PluginClassLoader

java.lang.Object

java.lang.ClassLoader

java.security.SecureClassLoader

java.net.URLClassLoader

org.plugface.core.internal.PluginClassLoader

All Implemented Interfaces:

Closeable, AutoCloseable

public class PluginClassLoader
extends URLClassLoader

Custom URLClassLoader that is used to load Plugin classes from Jar files.

It is used to give an empty set of permissions to plugins in SandboxSecurityPolicy#isPlugin(ProtectionDomain) so that plugins run in a protected sandbox. It also overrides the URLClassLoader.getPermissions(CodeSource) method so that custom permissions specified in a permissions.properties file can be applied to specific plugins.

Constructor Summary

Constructors

Constructor and Description
PluginClassLoader(URL jarFileUrl) Construct a PluginClassLoader from an single URL
PluginClassLoader(URL[] jarFileUrls) Construct a PluginClassLoader from an array of URL

Method Summary

Modifier and Type	Method and Description
Properties	getPermissionProperties()
protected PermissionCollection	getPermissions(CodeSource codesource) Create a set of Permission for the specified CodeSource, given a permissionProperties.
void	setPermissionProperties(Properties permissionProperties)

Methods inherited from class java.net.URLClassLoader

addURL, close, definePackage, findClass, findResource, findResources, 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

PluginClassLoader

public PluginClassLoader(URL jarFileUrl)

Construct a PluginClassLoader from an single URL

Parameters:

jarFileUrl - an Jar file URL

PluginClassLoader

public PluginClassLoader(URL[] jarFileUrls)

Construct a PluginClassLoader from an array of URL

Parameters:

jarFileUrls - the array of Jar file URL

Method Detail

getPermissions

protected PermissionCollection getPermissions(CodeSource codesource)

Create a set of Permission for the specified CodeSource, given a permissionProperties.

Overrides:

getPermissions in class URLClassLoader

Parameters:

codesource - the CodeSource to give the permissions to

Returns:

a PermissionCollection whith all the appropriate permissions

getPermissionProperties

public Properties getPermissionProperties()

setPermissionProperties

public void setPermissionProperties(Properties permissionProperties)