weka.core

Class PluginManager

java.lang.Object

weka.core.PluginManager

public class PluginManager
extends Object

Class that manages a global map of plugins. Provides static methods for registering and instantiating plugins. The package manager looks for, and processes, a PluginManager.props file in the top-level of a package.

Version:

$Revision: 12312 $

Author:

Mark Hall (mhall{[at]}pentaho{[dot]}com)

Constructor Summary

Constructors

Constructor and Description
PluginManager()

Method Summary

Modifier and Type	Method and Description
static void	addFromProperties(File propsFile) Add all key value pairs from the supplied property file
static void	addFromProperties(File propsFile, boolean maintainInsertionOrder) Add all key value pairs from the supplied property file
static void	addFromProperties(InputStream propsStream) Add all key value pairs from the supplied properties stream
static void	addFromProperties(InputStream propsStream, boolean maintainInsertionOrder) Add all key value pairs from the supplied properties stream
static void	addFromProperties(Properties props) Add all key value pairs from the supplied properties object
static void	addFromProperties(Properties props, boolean maintainInsertionOrder) Add all key value pairs from the supplied properties object
static void	addPlugin(String interfaceName, String name, String concreteType) Add a plugin.
static void	addPlugin(String interfaceName, String name, String concreteType, boolean maintainInsertionOrder) Add a plugin.
static void	addPluginResource(String resourceGroupID, String resourceDescription, String resourcePath) Add a resource.
static void	addToDisabledList(List<String> classnames) Add the supplied list of fully qualified class names to the disabled list
static void	addToDisabledList(String classname) Add the supplied fully qualified class name to the list of disabled plugins
static Object	getPluginInstance(String interfaceType, String name) Get an instance of a concrete implementation of a plugin type
static Set<String>	getPluginNamesOfType(String interfaceName) Get a set of names of plugins that implement the supplied interface.
static InputStream	getPluginResourceAsStream(String resourceGroupID, String resourceDescription) Get an input stream for a named resource under a given resource group ID.
static Map<String,String>	getResourcesWithGroupID(String resourceGroupID) Get a map of resources (description,path) registered under a given resource group ID.
static boolean	isInDisabledList(String classname) Returns true if the supplied fully qualified class name is in the disabled list
static int	numResourcesForWithGroupID(String resourceGroupID) Get the number of resources available under a given resource group ID.
static boolean	pluginRegistered(String interfaceType, String name) Checks if a named plugin exists in the map of registered plugins
static void	removeFromDisabledList(List<String> classnames) Remove the supplied list of fully qualified class names to the disabled list
static void	removeFromDisabledList(String classname) Remove the supplied fully qualified class name from the list of disabled plugins
static void	removePlugin(String interfaceName, String name) Remove a plugin.
static void	removePlugins(String interfaceName, List<String> names) Remove plugins of a specific type.

Methods inherited from class java.lang.Object

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

Constructor Detail

PluginManager

public PluginManager()

Method Detail

addToDisabledList

public static void addToDisabledList(List<String> classnames)

Add the supplied list of fully qualified class names to the disabled list

Parameters:

classnames - a list of class names to add

addToDisabledList

public static void addToDisabledList(String classname)

Add the supplied fully qualified class name to the list of disabled plugins

Parameters:

classname - the fully qualified name of a class to add

removeFromDisabledList

public static void removeFromDisabledList(List<String> classnames)

Remove the supplied list of fully qualified class names to the disabled list

Parameters:

classnames - a list of class names to remove

removeFromDisabledList

public static void removeFromDisabledList(String classname)

Remove the supplied fully qualified class name from the list of disabled plugins

Parameters:

classname - the fully qualified name of a class to remove

isInDisabledList

public static boolean isInDisabledList(String classname)

Returns true if the supplied fully qualified class name is in the disabled list

Parameters:

classname - the name of the class to check

Returns:

true if the supplied class name is in the disabled list

addFromProperties

public static void addFromProperties(File propsFile)
                              throws Exception

Add all key value pairs from the supplied property file

Parameters:

propsFile - the properties file to add

Throws:

Exception - if a problem occurs

addFromProperties

public static void addFromProperties(File propsFile,
                                     boolean maintainInsertionOrder)
                              throws Exception

Add all key value pairs from the supplied property file

Parameters:

propsFile - the properties file to add

maintainInsertionOrder - true if the order of insertion of implementations is to be preserved (rather than sorted order)

Throws:

Exception - if a problem occurs

addFromProperties

public static void addFromProperties(InputStream propsStream)
                              throws Exception

Add all key value pairs from the supplied properties stream

Parameters:

propsStream - an input stream to a properties file

Throws:

Exception - if a problem occurs

addFromProperties

public static void addFromProperties(InputStream propsStream,
                                     boolean maintainInsertionOrder)
                              throws Exception

Add all key value pairs from the supplied properties stream

Parameters:

propsStream - an input stream to a properties file

maintainInsertionOrder - true if the order of insertion of implementations is to be preserved (rather than sorted order)

Throws:

Exception - if a problem occurs

addFromProperties

public static void addFromProperties(Properties props)
                              throws Exception

Add all key value pairs from the supplied properties object

Parameters:

props - a Properties object

Throws:

Exception - if a problem occurs

addFromProperties

public static void addFromProperties(Properties props,
                                     boolean maintainInsertionOrder)
                              throws Exception

Add all key value pairs from the supplied properties object

Parameters:

props - a Properties object

maintainInsertionOrder - true if the order of insertion of implementations is to be preserved (rather than sorted order)

Throws:

Exception - if a problem occurs

addPluginResource

public static void addPluginResource(String resourceGroupID,
                                     String resourceDescription,
                                     String resourcePath)

Add a resource.

Parameters:

resourceGroupID - the ID of the group under which the resource should be stored

resourceDescription - the description/ID of the resource

resourcePath - the path to the resource

getPluginResourceAsStream

public static InputStream getPluginResourceAsStream(String resourceGroupID,
                                                    String resourceDescription)
                                             throws IOException

Get an input stream for a named resource under a given resource group ID.

Parameters:

resourceGroupID - the group ID that the resource falls under

resourceDescription - the description/ID of the resource

Returns:

an InputStream for the resource

Throws:

IOException - if the group ID or resource description/ID are not known to the PluginManager, or a problem occurs while trying to open an input stream

numResourcesForWithGroupID

public static int numResourcesForWithGroupID(String resourceGroupID)

Get the number of resources available under a given resource group ID.

Parameters:

resourceGroupID - the group ID of the resources

Returns:

the number of resources registered under the supplied group ID

getResourcesWithGroupID

public static Map<String,String> getResourcesWithGroupID(String resourceGroupID)

Get a map of resources (description,path) registered under a given resource group ID.

Parameters:

resourceGroupID - the group ID of the resources to get

Returns:

a map of resources registered under the supplied group ID, or null if the resourceGroupID is not known to the plugin manager

getPluginNamesOfType

public static Set<String> getPluginNamesOfType(String interfaceName)

Get a set of names of plugins that implement the supplied interface.

Parameters:

interfaceName - the fully qualified name of the interface to list plugins for

Returns:

a set of names of plugins

addPlugin

public static void addPlugin(String interfaceName,
                             String name,
                             String concreteType)

Add a plugin.

Parameters:

interfaceName - the fully qualified interface name that the plugin implements

name - the name/short description of the plugin

concreteType - the fully qualified class name of the actual concrete implementation

addPlugin

public static void addPlugin(String interfaceName,
                             String name,
                             String concreteType,
                             boolean maintainInsertionOrder)

Add a plugin.

Parameters:

interfaceName - the fully qualified interface name that the plugin implements

name - the name/short description of the plugin

concreteType - the fully qualified class name of the actual concrete implementation

maintainInsertionOrder - true if the order of insertion of implementations is to be preserved (rather than sorted order)

removePlugins

public static void removePlugins(String interfaceName,
                                 List<String> names)

Remove plugins of a specific type.

Parameters:

interfaceName - the fully qualified interface name that the plugins to be remove implement

names - a list of named plugins to remove

removePlugin

public static void removePlugin(String interfaceName,
                                String name)

Remove a plugin.

Parameters:

interfaceName - the fully qualified interface name that the plugin implements

name - the name/short description of the plugin

pluginRegistered

public static boolean pluginRegistered(String interfaceType,
                                       String name)

Checks if a named plugin exists in the map of registered plugins

Parameters:

interfaceType - the fully qualified interface name of the plugin type

name - the name/short description of the plugin to get

Returns:

true if the named plugin exists

getPluginInstance

public static Object getPluginInstance(String interfaceType,
                                       String name)
                                throws Exception

Get an instance of a concrete implementation of a plugin type

Parameters:

interfaceType - the fully qualified interface name of the plugin type

name - the name/short description of the plugin to get

Returns:

the concrete plugin or null if the plugin is disabled

Throws:

Exception - if the plugin can't be found or instantiated