Package de.iip_ecosphere.platform.support.plugins

Class URLPluginSetupDescriptor

java.lang.Object

de.iip_ecosphere.platform.support.plugins.URLPluginSetupDescriptor

All Implemented Interfaces:

PluginSetupDescriptor

Direct Known Subclasses:

ClasspathFilePluginSetupDescriptor, FolderClasspathPluginSetupDescriptor, ResourceClasspathPluginSetupDescriptor

public class URLPluginSetupDescriptor
extends Object
implements PluginSetupDescriptor

Default URL-based plugin setup descriptor. Typically, a specific descriptor inherits from this class and sets up the required information in a constructor without arguments.

Author:

Holger Eichelberger, SSE

Field Summary

Fields

Modifier and Type	Field	Description
private URL[]	urls

Constructor Summary

Constructors

Constructor	Description
URLPluginSetupDescriptor(URL[] urls)	Creates an URL plugin setup descriptor.

Method Summary

Modifier and Type	Method	Description
ClassLoader	createClassLoader(ClassLoader parent)	Returns the class loader being responsible for loading the plugin.
protected ClassLoader	createClassLoader(URL[] urls, ClassLoader parent)	Actually creates the classloader.
protected URL[]	getURLs()	Returns the URLs.
static URL[]	toURL(File... files)	Turns all files to URL instances.
static URL[]	toURL(String... urls)	Turns all urls to URL instances.
static URL[]	toURLSafe(File... files)	Turns all files to URL instances, logs errors.
static URL[]	toURLSafe(String... urls)	Turns all urls to URL instances, logs errors.

Methods inherited from class java.lang.Object

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

Methods inherited from interface de.iip_ecosphere.platform.support.plugins.PluginSetupDescriptor

getInstallDir, getPluginDescriptors, preventDuplicates

Field Details

urls

private URL[] urls

Constructor Details

URLPluginSetupDescriptor

public URLPluginSetupDescriptor(URL[] urls)

Creates an URL plugin setup descriptor.

Parameters:

urls - the URLs to load classes from

See Also:

• toURL(String[])

Method Details

toURL

public static URL[] toURL(String... urls)
                   throws IllegalArgumentException

Turns all urls to URL instances.

Parameters:

urls - the URLs to convert

Returns:

the converted URLs

Throws:

IllegalArgumentException - if one of the urls has invalid syntax

toURLSafe

public static URL[] toURLSafe(String... urls)

Turns all urls to URL instances, logs errors.

Parameters:

urls - the URLs to convert

Returns:

the converted URLs

See Also:

• toURL(String[])

toURL

public static URL[] toURL(File... files)
                   throws MalformedURLException

Turns all files to URL instances.

Parameters:

files - the files to convert

Returns:

the converted URLs

Throws:

MalformedURLException - if one of the urls has invalid syntax

toURLSafe

public static URL[] toURLSafe(File... files)

Turns all files to URL instances, logs errors.

Parameters:

files - the files to convert

Returns:

the converted URLs

See Also:

• toURL(String[])

createClassLoader

public ClassLoader createClassLoader(ClassLoader parent)

Description copied from interface: PluginSetupDescriptor

Returns the class loader being responsible for loading the plugin.

Specified by:

createClassLoader in interface PluginSetupDescriptor

Parameters:

parent - the parent class loader with basic dependencies to use for loading this plugin

Returns:

the class loader

createClassLoader

protected ClassLoader createClassLoader(URL[] urls,
 ClassLoader parent)

Actually creates the classloader.

Parameters:

urls - the URLs to create the classloader from

parent - the parent class loader

Returns:

the created classloader

getURLs

protected URL[] getURLs()

Returns the URLs.

Returns:

the URLs