com.logicaldoc.util.plugin

Class PluginRegistry

java.lang.Object

com.logicaldoc.util.plugin.PluginRegistry

Direct Known Subclasses:

DefaultPluginRegistry

public abstract class PluginRegistry
extends Object

Central point where plugins are loaded and handled. The class is abstract and must be personalized as needed. The used implementation can be specified with the 'logicaldoc.app.pluginregistry' system property.

Since:

3.0

Author:

Marco Meschieri - Logical Objects

Field Summary

Fields

Modifier and Type	Field and Description
protected org.java.plugin.PluginManager	manager

Constructor Summary

Constructors

Constructor and Description
PluginRegistry()

Method Summary

Methods

Modifier and Type	Method and Description
Collection<org.java.plugin.registry.Extension>	getExtensions(String pluginId, String extensionPoint) Returns the extensions connected to the specified extension point
static PluginRegistry	getInstance()
org.java.plugin.PluginManager	getManager()
org.java.plugin.registry.PluginDescriptor	getPlugin(String pluginId) Retrieve the plugin descriptor
static File	getPluginHome(String pluginName) This method retrieves the folder of the given plugin.
static File	getPluginResource(String pluginName, String path) This method retrieves a plugin folder resource (file or folder).
Collection<org.java.plugin.registry.PluginDescriptor>	getPlugins() Retrieves the list of registered plugins
static File	getPluginsDir() This method retrieves the plugins root folder.
List<org.java.plugin.registry.Extension>	getSortedExtensions(String pluginId, String extensionPoint, String sortingParameter) Returns the extensions connected to the specified extension point
void	init(String pluginsDir) Initializes all found plugins
protected abstract void	initPlugins(Map<String,org.java.plugin.registry.Identity> plugins) Initializes found plugins
boolean	isRestartRequired()
protected List<org.java.plugin.PluginManager.PluginLocation>	locatePlugins(String pluginsDirectoryPath)

Methods inherited from class java.lang.Object

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

Field Detail

manager

protected org.java.plugin.PluginManager manager

Constructor Detail

PluginRegistry

public PluginRegistry()

Method Detail

getInstance

public static PluginRegistry getInstance()

init

public void init(String pluginsDir)

Initializes all found plugins

initPlugins

protected abstract void initPlugins(Map<String,org.java.plugin.registry.Identity> plugins)

Initializes found plugins

Parameters:

plugins - Map of found plugins

locatePlugins

protected List<org.java.plugin.PluginManager.PluginLocation> locatePlugins(String pluginsDirectoryPath)

getManager

public org.java.plugin.PluginManager getManager()

getExtensions

public Collection<org.java.plugin.registry.Extension> getExtensions(String pluginId,
                                                           String extensionPoint)

Returns the extensions connected to the specified extension point

Parameters:

pluginId - The plugin identifier

extensionPoint - The extension point id

Returns:

List of connected extensions

getSortedExtensions

public List<org.java.plugin.registry.Extension> getSortedExtensions(String pluginId,
                                                           String extensionPoint,
                                                           String sortingParameter)

Returns the extensions connected to the specified extension point

Parameters:

pluginId - The plugin identifier

extensionPoint - The extension point id

sortingParameter - Extensions will be sorted by this parameter (if null 'position' parameter is used)

Returns:

List of connected extensions

getPlugins

public Collection<org.java.plugin.registry.PluginDescriptor> getPlugins()

Retrieves the list of registered plugins

Returns:

The list of registered plugins descriptors

getPlugin

public org.java.plugin.registry.PluginDescriptor getPlugin(String pluginId)

Retrieve the plugin descriptor

Returns:

The plugin descriptor

isRestartRequired

public boolean isRestartRequired()

getPluginHome

public static File getPluginHome(String pluginName)

This method retrieves the folder of the given plugin. If not exists, it creates the folder. The folder is: /

Parameters:

pluginName - The plugin name

getPluginsDir

public static File getPluginsDir()

This method retrieves the plugins root folder. If not exists, it creates the folder. The folder is:

getPluginResource

public static File getPluginResource(String pluginName,
                     String path)

This method retrieves a plugin folder resource (file or folder). If the resource is a folder and not exists, it creates the folder. The folder will be: //

Parameters:

pluginName - The plugin name

path - The resource path

Returns: