com.denodo.configuration.metadata.manager

Class MetadataManagerImpl

java.lang.Object

com.denodo.configuration.metadata.manager.MetadataManager

com.denodo.configuration.metadata.manager.MetadataManagerImpl

public class MetadataManagerImpl
extends MetadataManager

Constructor Summary

Constructors

Constructor and Description
MetadataManagerImpl()

Method Summary

Modifier and Type	Method and Description
PluginInfo	addPlugin(String fileName, byte[] fileContents) Adds a new plugin (custom element implementation) to the plugins register and its metadata to the the meta-configuration register.
void	exportPlugins(String folder) Writes the collection of plugins files to the given folder.
void	exportPlugins(String folder, Collection<String> pluginNames) Writes the collection of plugins files to the given folder.
Collection<String>	getElementSubTypes(String type) Obtains all the subTypes for the given element type with its meta-configuration available in the system.
Collection<String>	getElementTypes() Obtains all the types of elements with its meta-configuration available in the system.
MetaConfiguration	getMetaConfiguration(String type, String subType) Obtains the MetaConfiguration for the element matching the specified type and subType.
Collection<MetaConfiguration>	getMetaConfigurations(String type) Obtains a Collection of MetaConfiguration.
Class<?>	getPluginClass(MetaConfiguration metaConfig) Returns the class implementing the plugin (custom element implementation).
Class<?>	getPluginClass(String pluginName) Returns the class implementing the the plugin (custom element implementation).
PluginInfo	getPluginDetails(String pluginName) Obtains the plugin details(custom element implementation) of the specified identifier.
Collection<PluginInfo>	getPlugins() Obtains the collection of plugins (custom element implementations ) registered in the application.
Collection<String>	importPlugins(String folder, boolean replace) Loads plugins files from the given folder.
void	removePlugin(String pluginName) Removes the plugin (custom element implementation) with the specified identifier and its metadata.

Methods inherited from class com.denodo.configuration.metadata.manager.MetadataManager

getInstance

Methods inherited from class java.lang.Object

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

Constructor Detail

MetadataManagerImpl

public MetadataManagerImpl()
                    throws InternalErrorException

Throws:

InternalErrorException

Method Detail

getElementTypes

public Collection<String> getElementTypes()
                                   throws InternalErrorException

Description copied from class: MetadataManager

Obtains all the types of elements with its meta-configuration available in the system.

Specified by:

getElementTypes in class MetadataManager

Returns:

Collection of element types.

Throws:

InternalErrorException - if a severe error occurs.

getElementSubTypes

public Collection<String> getElementSubTypes(String type)
                                      throws InstanceNotFoundException,
                                             InternalErrorException

Description copied from class: MetadataManager

Obtains all the subTypes for the given element type with its meta-configuration available in the system.

Specified by:

getElementSubTypes in class MetadataManager

Returns:

Collection of all the subtypes of the given element type.

Throws:

InstanceNotFoundException - if no element with the specified type could be found.

InternalErrorException - if a severe error occurs.

getMetaConfigurations

public Collection<MetaConfiguration> getMetaConfigurations(String type)
                                                    throws InstanceNotFoundException,
                                                           InternalErrorException

Description copied from class: MetadataManager

Obtains a Collection of MetaConfiguration. If the element is categorized according to its type its meta-configuration is returned. If the element is categorized according to its type and subtype the meta-configuration of all its subTypes is returned.

Specified by:

getMetaConfigurations in class MetadataManager

Returns:

Collection of MetaConfiguration

Throws:

InstanceNotFoundException - if no element with the specified type could be found.

InternalErrorException - if a severe error occurs.

getMetaConfiguration

public MetaConfiguration getMetaConfiguration(String type,
                                              String subType)
                                       throws InstanceNotFoundException,
                                              InternalErrorException

Description copied from class: MetadataManager

Obtains the MetaConfiguration for the element matching the specified type and subType.

Specified by:

getMetaConfiguration in class MetadataManager

Returns:

MetaConfiguration

Throws:

InstanceNotFoundException - if no element with the specified type and subType could be found.

InternalErrorException - if a severe error occurs.

addPlugin

public PluginInfo addPlugin(String fileName,
                            byte[] fileContents)
                     throws DuplicateInstanceException,
                            InternalErrorException

Description copied from class: MetadataManager

Adds a new plugin (custom element implementation) to the plugins register and its metadata to the the meta-configuration register. The plugin jar file is copied to the plugin folder of the application. The plugin manifest file should include a section started with an attribute with the name as "Name" and value "CustomElement". This section should cointain three attributes:

• "PluginType": the type of the custom element the plugin implements
• "PluginName": the unique identifier of the custom element the plugin implements, the name acts as the subtype of the element too
• "PluginClass": the implementation class name of the custom element

otherwise the plugin will not be registered.

Specified by:

addPlugin in class MetadataManager

Parameters:

fileName - the name of the plugin jar file, that is the last name in the pathname's name sequence.

fileContents - a byte array with the plugin jar file contents.

Returns:

a PluginInfo specifying the details of the plugin added.

Throws:

DuplicateInstanceException - if a plugin with the same name already exists.

InternalErrorException - if a severe error occurs.

getPluginDetails

public PluginInfo getPluginDetails(String pluginName)
                            throws InstanceNotFoundException

Description copied from class: MetadataManager

Obtains the plugin details(custom element implementation) of the specified identifier.

Specified by:

getPluginDetails in class MetadataManager

Parameters:

pluginName - the unique identifier of the custom element the plugin implements, the name acts as the subtype of the element too.

Returns:

a PluginInfo specifying the details of the plugin.

Throws:

InstanceNotFoundException - if the plugin does not exist.

getPlugins

public Collection<PluginInfo> getPlugins()

Description copied from class: MetadataManager

Obtains the collection of plugins (custom element implementations ) registered in the application.

Specified by:

getPlugins in class MetadataManager

Returns:

a Collection of PluginInfo.

removePlugin

public void removePlugin(String pluginName)
                  throws InstanceNotFoundException,
                         InternalErrorException

Description copied from class: MetadataManager

Removes the plugin (custom element implementation) with the specified identifier and its metadata. Also removes all the configuration elements that matches the type and subtype (the plugin name) of the plugin removed.

Specified by:

removePlugin in class MetadataManager

Throws:

InstanceNotFoundException - if the plugin does not exist.

InternalErrorException - if a severe error occurs.

getPluginClass

public Class<?> getPluginClass(MetaConfiguration metaConfig)
                        throws InstanceNotFoundException,
                               InternalErrorException

Description copied from class: MetadataManager

Returns the class implementing the plugin (custom element implementation).

Specified by:

getPluginClass in class MetadataManager

Returns:

the class implementing the given plugin (a custom element).

Throws:

InstanceNotFoundException - if the plugin does not exist.

InternalErrorException - if a severe error occurs.

getPluginClass

public Class<?> getPluginClass(String pluginName)
                        throws InstanceNotFoundException,
                               InternalErrorException

Description copied from class: MetadataManager

Returns the class implementing the the plugin (custom element implementation).

Specified by:

getPluginClass in class MetadataManager

Returns:

the class implementing the given plugin (a custom element).

Throws:

InstanceNotFoundException - if the plugin does not exist.

InternalErrorException - if a severe error occurs.

exportPlugins

public void exportPlugins(String folder)

Description copied from class: MetadataManager

Writes the collection of plugins files to the given folder.

Specified by:

exportPlugins in class MetadataManager

exportPlugins

public void exportPlugins(String folder,
                          Collection<String> pluginNames)

Description copied from class: MetadataManager

Writes the collection of plugins files to the given folder.

Specified by:

exportPlugins in class MetadataManager

pluginNames - Collection with the names of the plugins that will be exported.

importPlugins

public Collection<String> importPlugins(String folder,
                                        boolean replace)

Description copied from class: MetadataManager

Loads plugins files from the given folder.

Specified by:

importPlugins in class MetadataManager

replace - if any existing plugin in the application should be replaced, and false otherwise.

Returns:

Collection a Collection of warnings informing the plugins that were replaced (if replace is true) or the plugins that were maintained as is (if replaces is false).