org.andromda.core.common
Class BasePlugin

java.lang.Object
  org.andromda.core.namespace.BaseNamespaceComponent
      org.andromda.core.common.BasePlugin

All Implemented Interfaces:

Plugin, NamespaceComponent

Direct Known Subclasses:

Cartridge, Library

public abstract class BasePlugin
extends BaseNamespaceComponent
implements Plugin

Represents the base plugin of AndroMDA. All Plugin instances inherit from this class.

Author:

Chad Brandon

Constructor Summary

BasePlugin()

Method Summary

void	addMacrolibrary(String macrolibrary) Adds a macro library to the TemplateEngine used by this BasePlugin.
void	addPropertyReference(String reference) Adds a property reference.
void	addTemplateObject(TemplateObject templateObject) Adds the templateObject to the collection of template objects that will be made available to the plugin during processing.
List<String>	getContents() Returns a list containing the name of each resource contained within the plugin.
protected Logger	getLogger() Retrieves the logger instance that should be used for logging output for the plugin sub classes.
protected URL	getMergeLocation() Gets the current merge location for this plugin.
String[]	getPropertyReferences() Gets all property references available for this cartridge.
TemplateEngine	getTemplateEngine() Gets the TemplateEngine which implements the template processing.
Collection<TemplateObject>	getTemplateObjects() Returns all the TemplateObject objects that are available to this Plugin.
void	initialize() Initializes the plugin.
protected void	populateTemplateContext(Map<String,Object> templateContext) Populates the templateContext with the properties and template objects defined in the plugin's descriptor.
void	setTemplateEngineClass(String templateEngineClass) Sets the template engine class for this cartridge.
void	shutdown() Shuts down the plugin.
String	toString()

Methods inherited from class org.andromda.core.namespace.BaseNamespaceComponent

getNamespace, getResource, setNamespace, setResource

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.andromda.core.namespace.NamespaceComponent

getNamespace, getResource, setNamespace, setResource

Constructor Detail

BasePlugin

public BasePlugin()

Method Detail

initialize

public void initialize()
                throws Exception

Description copied from interface: Plugin

Initializes the plugin.

Specified by:

initialize in interface Plugin

Throws:

Exception

See Also:

Plugin.initialize()

getMergeLocation

protected URL getMergeLocation()

Gets the current merge location for this plugin.

Returns:

the merge location (a file path).

shutdown

public void shutdown()

Description copied from interface: Plugin

Shuts down the plugin. The meaning of this is defined by the plugin itself. At least, it should close any logfiles.

Specified by:

shutdown in interface Plugin

See Also:

Plugin.shutdown()

addTemplateObject

public void addTemplateObject(TemplateObject templateObject)

Adds the templateObject to the collection of template objects that will be made available to the plugin during processing.

Parameters:

templateObject - the TemplateObject to add.

addMacrolibrary

public void addMacrolibrary(String macrolibrary)

Adds a macro library to the TemplateEngine used by this BasePlugin.

Parameters:

macrolibrary -

getTemplateObjects

public Collection<TemplateObject> getTemplateObjects()

Description copied from interface: Plugin

Returns all the TemplateObject objects that are available to this Plugin.

Specified by:

getTemplateObjects in interface Plugin

Returns:

a collection of TemplateObjects.

See Also:

Plugin.getTemplateObjects()

setTemplateEngineClass

public void setTemplateEngineClass(String templateEngineClass)

Sets the template engine class for this cartridge.

Parameters:

templateEngineClass - the Class of the template engine implementation.

getTemplateEngine

public TemplateEngine getTemplateEngine()

Description copied from interface: Plugin

Gets the TemplateEngine which implements the template processing.

Specified by:

getTemplateEngine in interface Plugin

Returns:

TemplateEngine

See Also:

Plugin.getTemplateEngine()

getPropertyReferences

public String[] getPropertyReferences()

Description copied from interface: Plugin

Gets all property references available for this cartridge. This is an array of names corresponding to property references.

Specified by:

getPropertyReferences in interface Plugin

Returns:

the Map of property references.

See Also:

Plugin.getPropertyReferences()

addPropertyReference

public void addPropertyReference(String reference)

Adds a property reference. Property references are those properties that are expected to be supplied by the calling client. These supplied properties are made available to the template during processing.

Parameters:

reference - the namespace of the reference.

populateTemplateContext

protected void populateTemplateContext(Map<String,Object> templateContext)

Populates the templateContext with the properties and template objects defined in the plugin's descriptor. If the templateContext is null, a new Map instance will be created before populating the context.

Parameters:

templateContext - the context of the template to populate.

getContents

public List<String> getContents()

Description copied from interface: Plugin

Returns a list containing the name of each resource contained within the plugin.

Specified by:

getContents in interface Plugin

Returns:

contents

See Also:

Plugin.getContents()

getLogger

protected Logger getLogger()

Retrieves the logger instance that should be used for logging output for the plugin sub classes.

Returns:

the logger.

toString

public String toString()

Overrides:

toString in class Object

See Also:

Object.toString()